1. 为什么选择VSCode开发QT应用很多从QT Creator转向VSCode的开发者最初都是被那个红色波浪线逼疯的。我自己刚开始用QT Creator时经常对着飘红的头文件发愣——明明编译没问题为什么编辑器就是不认后来发现VSCode的C/C插件配合正确配置后智能提示的准确度反而更高。VSCode的优势在于它的轻量化和扩展性。启动速度比QT Creator快至少3倍内存占用不到一半。更重要的是你可以自由组合各种插件Git集成、Markdown预览、Docker支持...这些在传统IDE里要么没有要么用起来特别别扭。我现在的标准工作流是左边VSCode写代码右边开着终端和文档效率提升非常明显。不过要提醒的是VSCode本质上还是个编辑器。如果你需要可视化设计UI还是得回到QT Creator。但纯代码开发场景下特别是大型项目VSCode的响应速度和代码导航体验绝对值得一试。2. 基础环境搭建2.1 必备软件安装首先确保你的系统已经装好这两样东西最新版VSCode建议从官网下载QT开发套件包含MinGW编译器安装QT时有个细节容易踩坑记得勾选MinGW组件。我见过好几个新手安装时一路下一步结果最后找不到g编译器。建议选择QT 5.15或更高版本它们对C17的支持更完善。装好后检查下环境变量。打开cmd输入g --version qmake -v如果都能正常输出版本信息说明基础环境OK。2.2 关键插件配置在VSCode扩展商店搜索安装C/C微软官方出品必装CMake Tools如果你用CMake管理项目Qt Configure可选简化配置流程装完插件后有个隐藏技巧按住CtrlShiftP打开命令面板输入C/C: Edit Configurations (UI)。这个图形化界面比直接改json文件友好多了特别适合配置初期。3. 项目配置实战3.1 创建示例工程先用QT Creator新建一个最简单的Widgets Application勾选Generate form选项。这个步骤不能省因为QT Creator会自动生成.pro文件和基础项目结构。我试过手动创建结果各种路径问题折腾了一下午。重点来了关闭QT Creator用VSCode打开这个项目文件夹。你会立即看到main.cpp里的QT头文件全部飘红这就是我们要解决的核心问题。3.2 配置c_cpp_properties.json在VSCode里按F1输入C/C: Edit Configurations (UI)会看到这样的界面编译器路径指向QT自带的g通常在Qt/Tools/mingw版本号/bin/g.exe包含路径需要添加两个关键路径QT核心头文件Qt/5.15.2/mingw81_64/include编译器自有头文件Qt/Tools/mingw81_64/lib/gcc/x86_64-w64-mingw32/8.1.0/include这里有个实用技巧打开QT Creator随便打开一个项目在项目→构建环境里可以看到完整的包含路径直接复制过来就行。3.3 解决常见报错最常遇到的三个问题无法打开源文件99%是包含路径没设对。检查路径中是否有中文或空格Windows下建议全部用正斜杠/编译器不匹配确保c_cpp_properties.json里的编译器路径和QT项目使用的编译器一致IntelliSense卡顿在设置里搜索C_Cpp.intelliSenseCacheSize改成1024或更大4. 高级调优技巧4.1 多版本QT支持如果你同时维护多个QT版本的项目可以这样配置{ configurations: [ { name: Qt 5.15, includePath: [ ${workspaceFolder}/**, D:/Qt/5.15.2/mingw81_64/include/** ], compilerPath: D:/Qt/Tools/mingw81_64/bin/g.exe }, { name: Qt 6.2, includePath: [ ${workspaceFolder}/**, D:/Qt/6.2.4/mingw_64/include/** ], compilerPath: D:/Qt/Tools/mingw1120_64/bin/g.exe } ] }通过左下角的状态栏可以快速切换配置比改环境变量方便多了。4.2 代码片段加速开发在VSCode中创建QT代码片段能极大提升效率。比如我常用的QPushButton片段{ QPushButton: { prefix: qpb, body: [ QPushButton *${1:button} new QPushButton(${2:parent});, ${1:button}-setText(\${3:text}\);, QObject::connect(${1:button}, QPushButton::clicked, [](){, ${4:// code}, }); ] } }输入qpb按Tab键自动生成完整按钮代码连信号槽都给你搭好了。5. 编译与调试方案虽然本文主要讲代码编写但很多读者会问能不能直接在VSCode里编译运行答案是肯定的但需要一些额外配置。最简单的方法是使用CMake。在项目根目录创建CMakeLists.txtcmake_minimum_required(VERSION 3.5) project(MyQtApp) set(CMAKE_CXX_STANDARD 17) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTORCC ON) set(CMAKE_AUTOUIC ON) find_package(Qt5 COMPONENTS Widgets REQUIRED) add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h ) target_link_libraries(${PROJECT_NAME} Qt5::Widgets)然后安装CMake插件按F7就能编译。调试更简单直接按F5启动调试会话断点、变量监控都和QT Creator体验一致。不过说实话我平时还是习惯在VSCode写代码用QT Creator编译调试。毕竟后者在QT项目构建方面确实更专业两者配合使用反而能发挥各自优势。
告别QT Creator：在VSCode中配置智能感知，高效编写QT应用
发布时间：2026/6/15 9:52:39
1. 为什么选择VSCode开发QT应用很多从QT Creator转向VSCode的开发者最初都是被那个红色波浪线逼疯的。我自己刚开始用QT Creator时经常对着飘红的头文件发愣——明明编译没问题为什么编辑器就是不认后来发现VSCode的C/C插件配合正确配置后智能提示的准确度反而更高。VSCode的优势在于它的轻量化和扩展性。启动速度比QT Creator快至少3倍内存占用不到一半。更重要的是你可以自由组合各种插件Git集成、Markdown预览、Docker支持...这些在传统IDE里要么没有要么用起来特别别扭。我现在的标准工作流是左边VSCode写代码右边开着终端和文档效率提升非常明显。不过要提醒的是VSCode本质上还是个编辑器。如果你需要可视化设计UI还是得回到QT Creator。但纯代码开发场景下特别是大型项目VSCode的响应速度和代码导航体验绝对值得一试。2. 基础环境搭建2.1 必备软件安装首先确保你的系统已经装好这两样东西最新版VSCode建议从官网下载QT开发套件包含MinGW编译器安装QT时有个细节容易踩坑记得勾选MinGW组件。我见过好几个新手安装时一路下一步结果最后找不到g编译器。建议选择QT 5.15或更高版本它们对C17的支持更完善。装好后检查下环境变量。打开cmd输入g --version qmake -v如果都能正常输出版本信息说明基础环境OK。2.2 关键插件配置在VSCode扩展商店搜索安装C/C微软官方出品必装CMake Tools如果你用CMake管理项目Qt Configure可选简化配置流程装完插件后有个隐藏技巧按住CtrlShiftP打开命令面板输入C/C: Edit Configurations (UI)。这个图形化界面比直接改json文件友好多了特别适合配置初期。3. 项目配置实战3.1 创建示例工程先用QT Creator新建一个最简单的Widgets Application勾选Generate form选项。这个步骤不能省因为QT Creator会自动生成.pro文件和基础项目结构。我试过手动创建结果各种路径问题折腾了一下午。重点来了关闭QT Creator用VSCode打开这个项目文件夹。你会立即看到main.cpp里的QT头文件全部飘红这就是我们要解决的核心问题。3.2 配置c_cpp_properties.json在VSCode里按F1输入C/C: Edit Configurations (UI)会看到这样的界面编译器路径指向QT自带的g通常在Qt/Tools/mingw版本号/bin/g.exe包含路径需要添加两个关键路径QT核心头文件Qt/5.15.2/mingw81_64/include编译器自有头文件Qt/Tools/mingw81_64/lib/gcc/x86_64-w64-mingw32/8.1.0/include这里有个实用技巧打开QT Creator随便打开一个项目在项目→构建环境里可以看到完整的包含路径直接复制过来就行。3.3 解决常见报错最常遇到的三个问题无法打开源文件99%是包含路径没设对。检查路径中是否有中文或空格Windows下建议全部用正斜杠/编译器不匹配确保c_cpp_properties.json里的编译器路径和QT项目使用的编译器一致IntelliSense卡顿在设置里搜索C_Cpp.intelliSenseCacheSize改成1024或更大4. 高级调优技巧4.1 多版本QT支持如果你同时维护多个QT版本的项目可以这样配置{ configurations: [ { name: Qt 5.15, includePath: [ ${workspaceFolder}/**, D:/Qt/5.15.2/mingw81_64/include/** ], compilerPath: D:/Qt/Tools/mingw81_64/bin/g.exe }, { name: Qt 6.2, includePath: [ ${workspaceFolder}/**, D:/Qt/6.2.4/mingw_64/include/** ], compilerPath: D:/Qt/Tools/mingw1120_64/bin/g.exe } ] }通过左下角的状态栏可以快速切换配置比改环境变量方便多了。4.2 代码片段加速开发在VSCode中创建QT代码片段能极大提升效率。比如我常用的QPushButton片段{ QPushButton: { prefix: qpb, body: [ QPushButton *${1:button} new QPushButton(${2:parent});, ${1:button}-setText(\${3:text}\);, QObject::connect(${1:button}, QPushButton::clicked, [](){, ${4:// code}, }); ] } }输入qpb按Tab键自动生成完整按钮代码连信号槽都给你搭好了。5. 编译与调试方案虽然本文主要讲代码编写但很多读者会问能不能直接在VSCode里编译运行答案是肯定的但需要一些额外配置。最简单的方法是使用CMake。在项目根目录创建CMakeLists.txtcmake_minimum_required(VERSION 3.5) project(MyQtApp) set(CMAKE_CXX_STANDARD 17) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTORCC ON) set(CMAKE_AUTOUIC ON) find_package(Qt5 COMPONENTS Widgets REQUIRED) add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h ) target_link_libraries(${PROJECT_NAME} Qt5::Widgets)然后安装CMake插件按F7就能编译。调试更简单直接按F5启动调试会话断点、变量监控都和QT Creator体验一致。不过说实话我平时还是习惯在VSCode写代码用QT Creator编译调试。毕竟后者在QT项目构建方面确实更专业两者配合使用反而能发挥各自优势。
