现代Qt开发——0.1——如何在IDE中配置Qt环境相关仓库仍然已经开源正在积极火热的建设之中欢迎各位大佬提Issue和PR链接地址https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeQt1. 前言为什么 IDE 配置能折腾死人老实说我第一次用 VS Code 跑 Qt 项目的时候对着满屏的红色波浪线差点砸键盘。智能提示不工作、找不到头文件、CMake 配置报错——这些问题每一个都够让人崩溃的。后来我才发现问题不是 IDE 不好用而是我根本没配对。Qt 的开发环境确实有点特殊有 MOC、有 RCC、有 UIC再加上 CMake 的各种变量配错一个地方整条链就断了。所以这一篇我们不是走马观花而是真的要把三个主流 IDEVS Code、CLion、Qt Creator的配置彻底搞明白。你可以选一个自己喜欢的主力另外两个备用——毕竟总有那么些时候主力 IDE 突然抽风有个备用能救命。现在我们要做的是选好你的武器把它调教到能顺滑地写 Qt 代码。2. 环境说明本篇假设你已经完成了上一篇的 Qt 安装并且前置条件验证方法Qt 6.9.1 已安装qmake --version能看到版本号CMake 可用cmake --version输出 ≥ 3.26编译器已装Windows: MSVC 或 MinGWLinux: GCC我们会分别配置三个 IDE你可以按需跳跃到感兴趣的部分。重要提示无论选哪个 IDE确保先在命令行能成功编译一个 Qt 工程。IDE 只是包装底层工具链才是核心。命令行跑不通IDE 配再花也没用。3. VS Code 配置3.1 必装插件清单VS Code 装好之后你至少需要这几个插件C/C由 Microsoft 提供智能提示、语法高亮、跳转定义别装错了是微软那个下载量最高的CMake ToolsCMake 项目管理、一键构建调试这是个神器不用它你会累死Qt C Helpers可选但推荐信号槽语法高亮、.ui 文件预览写 Qt 项目的贴心助手⚠️坑 #1插件装错了❌ 错误做法看到名字像的就装最后装了一堆重复功能的✅ 正确做法认准发布者Microsoft 的 C/C、twxs 的 CMake Tools 后果插件冲突、智能提示乱报错、你以为是代码问题其实是插件问题 一句话记住VS Code 插件看发布者别看下载量盲目装3.2 CMake 工具链配置VS Code 的 CMake Tools 插件需要知道你的编译器和 Qt 在哪里。打开任意 CMake 项目或者新建一个按下CtrlShiftP输入CMake: Select a Kit第一次运行它会让你选择编译器Windows MSVC选 Visual Studio Community 2019 Release - amd64Windows MinGW选 GCC x86_64-w64-mingw32Linux/WSL2选 GCC x86_64-linux-gnu然后需要设置 Qt 的路径。同样是CtrlShiftPCMake: Configure Args添加以下参数-DCMAKE_PREFIX_PATHC:/Qt/6.9.1/mingw_64 # Linux 下改成 -DCMAKE_PREFIX_PATH/home/你的用户名/Qt/6.9.1/gcc_64这个配置会保存到.vscode/cmake-kits.json里不用每次都设。3.3 智能提示配置c_cpp_properties.jsonVS Code 的智能提示需要知道 Qt 的头文件在哪里。按CtrlShiftPC/C: Edit Configurations (UI)在 “Include path” 里添加[${workspaceFolder}/**,C:/Qt/6.9.1/mingw_64/include,C:/Qt/6.9.1/mingw_64/include/QtCore,C:/Qt/6.9.1/mingw_64/include/QtWidgets,C:/Qt/6.9.1/mingw_64/include/QtGui]Linux 路径同理调整。配置完后你会看到红色的波浪线消失#include QApplication不再报错。3.4 调试配置launch.json按 F5 调试时VS Code 会读取.vscode/launch.json。CMake Tools 会自动生成一个但你可能需要微调{version:0.2.0,configurations:[{name:Debug Qt App,type:cppdbg,request:launch,program:${command:cmake.launchTargetPath},args:[],stopAtEntry:false,cwd:${workspaceFolder},environment:[],externalConsole:false,MIMode:gdb,setupCommands:[{description:Enable pretty-printing,text:-enable-pretty-printing,ignoreFailures:true}]}]}随堂测验口述回答用自己的话说说为什么 VS Code 需要配置 CMAKE_PREFIX_PATH不配会怎样(请先自己想一下再往下滑看答案)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━答案参考CMAKE_PREFIX_PATH 告诉 CMake 去哪里找 Qt 的库文件和 CMake 配置不配的话 find_package(Qt6) 会找不到整条构建链就断了━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━4. CLion 配置4.1 工具链设置CLion 的好处是它对 CMake 的支持是原生的配置起来比 VS Code 简单一些。打开 Settings → Build, Execution, Deployment → Toolchains设置项Windows MinGWWindows MSVCLinux/WSL2CMakebundled 或系统安装同左同左Build toolNinja 或 MinGW Makefiles同左Unix MakefilesC Compilergcc 路径cl.exeVS自带/usr/bin/gccC Compilerg 路径cl.exe/usr/bin/gDebuggergdb 或 lldb同左gdb⚠️坑 #2CLon 找不到 Visual Studio❌ 错误做法装了 VS 但 CLion 报错找不到 cl.exe✅ 正确做法用 VS Installer里的 “Developer Command Prompt for VS” 路径 后果CLion 无法使用 MSVC 编译器被迫用 MinGW 一句话记住CLion 需要知道 VS 工具链的确切路径不是装了就能找到4.2 CMake Profile 配置在同一设置页面找到 CMake profiles添加一个新的 Profile配置如下# Build directory ${workspaceFolder}/cmake-build-debug # CMake options (关键部分) -DCMAKE_PREFIX_PATHC:/Qt/6.9.1/mingw_64 # Build type Debug # Toolchain 默认即可CLion 会自动检测保存后CLion 会在右上方显示这个 Profile切换过去就行。4.3 运行与调试CLion 的调试配置很直观点击右上角的运行配置选择 Edit…在 “Program arguments” 里填参数如果需要“Working directory” 默认是项目根目录。按 ShiftF9 就能开始调试。CLion 的调试器体验比 VS Code 好一些尤其是查看 Qt 容器内容的时候。4.4 Qt Quick (.qml) 支持CLion 默认对 QML 的支持有限需要额外配置安装插件Settings → Plugins → 搜索 “QML”安装 QML Support 插件。随堂测验代码填空补全以下 CLion CMake 配置使其能找到 Qt 6.9.1# CMake options ______C:/Qt/6.9.1/mingw_64 # Build type ______ # 如果要启用 Qt 的 MOC、RCC、UIC set(______ ON) set(CMAKE_AUTORCC ON) set(CMAKE_AUTOUIC ON) *(提示第一个是 CMAKE_PREFIX_PATH第二个是 Debug/Release第三个是 AUTOMOC)* ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ **答案参考** cmake -DCMAKE_PREFIX_PATHC:/Qt/6.9.1/mingw_64 Debug CMAKE_AUTOMOC ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━5. Qt Creator 配置5.1 为什么还要说 Qt Creator我知道有些人可能觉得 Qt Creator 界面老旧但说实话它是官方 IDE对 Qt 的支持是原生的。有些功能——比如 .ui 文件的可视化编辑、信号槽的图形化连接——只有 Qt Creator 做得最好。所以建议是主力可以选别的但 Qt Creator 留着备用特别是做 UI 设计的时候。5.2 首次启动配置Qt Creator 首次启动时会自动检测 Qt 安装如果检测不到打开 Edit → Preferences → Kits → Qt Versions手动添加名称: Qt 6.9.1 (mingw_64) qmake 路径: C:/Qt/6.9.1/mingw_64/bin/qmake.exe然后在 Kits 页面确保有一个 Kit 包含这个 Qt 版本。5.3 打开 CMake 项目Qt Creator 打开 CMake 项目超简单File → Open File or Project → 选择CMakeLists.txt它会自动配置然后你就可以直接按 CtrlR 运行了。⚠️坑 #3Kit 未配置导致编译失败❌ 错误做法看到没 Kit 就不管直接尝试编译✅ 正确做法先确认 Kits 页面有一个有效的 Kit编译器 Qt 版本组合 后果项目无法构建报错 “No valid kit found” 一句话记住Qt Creator 的 Kit 是编译器 Qt 调试器的组合缺一不可5.4 .ui 文件可视化编辑这是 Qt Creator 的杀手级功能。双击项目里的 .ui 文件会打开一个可视化设计器左侧是控件面板拖拽就能加到界面上右侧是属性编辑器改字体、颜色、大小底部是信号槽编辑器图形化连接信号和槽说实话这个功能真的好用特别是对新手。等你熟练了可以手写 UI但刚开始用可视化工具能省很多时间。随堂测验调试挑战以下配置片段有问题请问哪里错了会导致什么后果// .vscode/cmake-kits.json{name:MinGW,compilers:{C:C:/mingw64/bin/gcc.exe,CXX:C:/mingw64/bin/g.exe}} 同时launch.json 里没有配置 program 字段。 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ **答案参考** - 问题cmake-kits.json 里缺少 CMAKE_PREFIX_PATHlaunch.json 缺少 program - 后果CMake 找不到 Qt无法找到可执行文件来调试 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ## 6. 三端对比与选择建议 | 特性 | VS Code | CLion | Qt Creator | |------|---------|-------|------------| | 轻量程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | | CMake 支持 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | | Qt 专用功能 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | | 调试体验 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | | 插件生态 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | | 价格 | 免费 | 收费学生免费 | 免费 | **选择建议** - **预算敏感 喜欢折腾**VS Code - **重度 CMake 用户 预算充足**CLion - **Qt 专用 UI 设计频繁**Qt Creator ## 7. 通用调试技巧 无论你用哪个 IDE调试 Qt 项目有几个通用的要点 ### 7.1 查看 QString 内容 GDB 默认看不到 QString 的内部内容需要使用 pretty-printer。Qt Creator 自带VS Code 和 CLion 需要额外配置。 ### 7.2 信号槽调试 在 main.cpp 里加这一行可以看到信号槽的调用信息 cpp QLoggingCategory::setFilterRules(qt.core.qobject.connecttrue);7.3 断点位置Qt 的 MOC 会生成额外代码有时候断点会打在奇怪的地方。建议断点打在你自己写的函数里而不是 Qt 的内部函数。8. 练习项目练习项目三端 Hello Qt功能描述用三个 IDE 分别打开同一个 Qt Hello World 项目配置好工具链确保每个 IDE 都能成功编译运行。✅完成标准VS Code: F5 能调试智能提示正常CLion: 右上角能选 KitShiftF9 调试正常Qt Creator: 能打开项目CtrlR 运行正常三个 IDE 编译出的程序都能弹出 “Hello Qt” 窗口提示项目很简单一个 QApplication一个 QWidget 显示 “Hello Qt”先在命令行确认能编译再用 IDE 打开每个 IDE 配置 CMAKE_PREFIX_PATH 是关键VS Code 需要手动配 include pathCLion 和 Qt Creator 会自动检测9. 官方文档参考 Qt Creator 手册 · 官方 IDE 的完整文档 VS Code C 教程 · 微软官方配置指南 CLion CMake 教程 · JetBrains CMake 支持链接已验证2026-03-17 可访问到这里就大功告成了选一个你喜欢的 IDE把它调教顺手。后面我们就要正式进入 Qt 代码的世界了。记住IDE 只是工具代码才是核心。别在配置上花太多时间能用就行。━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━相关阅读入门 · 环境搭建 · 00 · Qt6 安装踩坑指南 - 相似度 100%深入理解Linux模块——第1章 Hello World内核模块内核编程的第一步 - 相似度 60%