张涵涵很多C++开发者第一次用CLion写完hello world，第二个需求往往就是：在CLion里构建一个Qt项目。这时候你搜出来的教程，十有八九会劝你装Qt Creator，理由通常是“CLion对Qt支持不好”。我一开始也信了，直到把Qt Creator装完、折腾完工程文件、发现和CLion的编辑习惯完全割裂之后，才明白真正的问题不是CLion不能写Qt，而是没人把正确的构建流程讲清楚。
这篇文章就是来解决这个问题的。我会从环境准备、CMake配置、调试排错到发布打包，完整走一遍用CLion从零到一构建Qt项目的流程。整个过程只依赖两个核心东西：CLion自带或系统安装的CMake，以及官方Qt SDK。适合已经在用CLion写C++、但没碰过Qt的开发者，也适合被Qt Creator的工程结构劝退、想用一套统一构建系统管理所有项目的人。
1. 为什么我选择在CLion里写Qt，而不是换个IDE
1.1 Qt Creator很好，但替代不了编辑器的肌肉记忆
先说实话，Qt Creator本身是个优秀的IDE，尤其在做QML开发、快速原型验证的时候，它的Designer和项目向导确实方便。但问题是，如果你已经习惯CLion的快捷键、代码智能提示、Git集成和重构工具，再切到Qt Creator会非常别扭。这种割裂感不是“多学一个工具”就能解决的，它直接影响每天的开发效率。我的选择很简单：既然CLion在主C++开发上已经用得很顺，那就想办法让Qt项目也跑在CLion里。
工具链统一这件事，长期看收益很大。一个团队里，有的人写算法库，有的人写业务界面，如果都用CLion管理所有CMake工程，新人入职第一天就不用纠结“哪个项目用哪个IDE”这种问题。Qt项目本质上就是一个C++项目，只是多了一套Qt库和几个处理步骤而已。
1.2 CLion与CMake：Qt6时代的天作之合
Qt从6.0开始，官方构建系统已经全面转向CMake，qmake退居二线。而CLion对CMake的支持是所有IDE里做得最彻底的一档：自动重载、目标级编译、单文件运行、CMake Profile管理都非常成熟。这俩凑在一起，等于说你的Qt项目不再需要任何额外的构建脚本，CLion的CMake配置直接就是Qt官方推荐的构建方式。
在CLion里建Qt项目，核心工作其实就一句话：写好CMakeLists.txt，让find_package找到Qt库，再处理一下Qt的元对象编译器相关设置。后面所有编译、运行、调试，都和普通C++项目没有区别。这也是“从零到一”最省心的路线。
1.3 一张表看懂四种工具组合的取舍
很多人在选择工具链时纠结不已，我把实测过的几种主流组合整理成一张表，供你参考：
| 工具组合 | CMake支持 | Qt元对象自动处理 | 调试体验 | QML设计器 | 获取成本 |
|---|---|---|---|---|---|
| Qt Creator | 完整 | 自动 | 较好 | 官方支持 | 免费 |
| CLion + CMake | 完整 | 需开启AUTOMOC | 优秀 | 较弱 | 商业/学生免费 |
| Visual Studio + Qt VS Tools | 一般 | 自动（MSVC） | 优秀 | 一般 | 社区版免费 |
| VS Code + CMake Tools | 完整 | 需手动配置 | 一般 | 差 | 免费 |
如果你的项目以C++ Widgets为主、不用大量QML界面，那CLion几乎是最顺手的选择。如果你重度依赖QML可视化设计，Qt Creator的Designer仍然不可替代。我自己的项目里QML用得少，所以CLion是完全够用的。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 开工前的环境底子：Qt、编译器、CMake怎么搭才不出错
2.1 先搞清楚你系统的编译链路：MinGW还是MSVC
很多人在CLion里配置Qt项目时第一步就卡住了，不是因为代码问题，而是Windows下的编译器选择搞错了。Qt官方安装包在Windows下有两种版本：MinGW版和MSVC版。MinGW是GCC的Windows移植版，MSVC是Visual Studio的编译工具链。这两个编译器生成的二进制格式不一样，不能混用。也就是说，如果你安装的是Qt的MSVC版本，那么CLion里的Toolchain就必须是Visual Studio的MSVC；如果你安装的是Qt的MinGW版本，CLion里的Toolchain就得用MinGW。
我在第一次踩坑时，装的是MSVC版本的Qt，但CLion默认用的是MinGW工具链，导致一编译就报一堆头文件找不到、链接器报错。所以建议你在装Qt之前，先想清楚自己系统里有什么编译器。如果你没有Visual Studio，也不想装它，那就选MinGW版本的Qt，然后在CLion里配置一个MinGW工具链。如果你装过Visual Studio，那就省事，直接选MSVC版Qt。
这台机器上我用的方案是：MSVC 2022 + Qt 6.5.3 MSVC版，CLion里新建一个Visual Studio工具链。这个组合在调试体验上是最好的，因为MSVC的调试器对Windows的调试信息格式支持最完善。
2.2 Qt安装时到底该勾选哪些组件
去Qt官网注册一个账号，下载在线安装器。安装过程中，会让你选组件，很多人面对这么长的组件列表就懵了。我的建议是，先别全选，按你的实际平台来：
- 如果你在Windows下开发，勾选Qt 6.x.x下的“MSVC 2019 64-bit”或者“MinGW 11.2.0 64-bit”，取决于你上面选定的编译器。
- 勾选“Qt Debug Symbols”和“Qt Sources”，调试的时候能进入Qt源码，排查问题非常方便。
- 组件列表里有“Qt Creator”，如果你打算长期用CLion，可以不用勾选，省几个GB空间。
- Additional Libraries里的组件按需选，做Widgets界面只需要Qt Base里的东西，默认就会包含。
安装完成后，默认路径在 C:\Qt\6.5.3\msvc2019_64 这种结构下。路径里不要带中文和空格，Qt本身没问题，但CMake和Ninja在部分旧版本里对中文路径支持不友好，容易出莫名其妙的问题。
2.3 CMake和Ninja从哪来
CLion自带了一套CMake和构建工具，通常路径在CLion安装目录的bin文件夹里，版本一般比较新，直接用就