1、认识Qt与构建系统：Qt框架简介、qmake与CMake的定位、选择qmake还是CMake。
各位同学好，我是老K。今天咱们来聊聊Qt工程的构建与编译配置。说实话，这话题看着基础，但我在带团队时发现，很多干了三五年的Qt开发者，对构建系统的理解还停留在「能跑就行」的阶段。嗯，这其实是个坑，后面我会细说。
1.1 Qt框架到底是什么？
Qt，说白了就是一个C++的图形界面框架。但它又不只是画界面那么简单。你想想看，一个完整的桌面应用需要什么？窗口、按钮、事件处理、网络通信、数据库操作、多线程……Qt把这些全给你封装好了。
我个人习惯把Qt理解成「C++界的瑞士军刀」。它提供了你开发跨平台应用所需的一切工具。我最早接触Qt是在2009年，那时候还在用Qt 4.6，做个简单的串口调试工具。当时就觉得，这玩意儿比MFC舒服太多了。
Qt的核心模块包括：
- QtCore：核心非GUI功能，像事件循环、信号槽、容器类
- QtGui：窗口系统、事件处理、2D图形
- QtWidgets：经典控件库，按钮、表格、树形控件都在这里
- QtNetwork：网络编程，TCP/UDP/HTTP都支持
- QtSql：数据库访问层
这里有个关键点：Qt不是单纯的UI库。它是一整套应用开发框架。你在项目中用到的很多功能，Qt其实都提供了现成的实现。我见过不少团队自己造轮子实现JSON解析、XML处理，结果发现Qt早就有了，而且性能更好。
核心认知：Qt = C++框架 + 跨平台抽象层 + 开发工具链。三者缺一不可。
1.2 构建系统是什么？qmake和CMake的定位
好，现在问题来了。你写了一大堆Qt代码，怎么把它变成可执行文件？这就轮到构建系统出场了。
构建系统，说白了就是一套自动化编译的规则。你告诉它「我有哪些源文件、用了哪些库、要生成什么目标」，它帮你搞定编译、链接、资源处理这些脏活累活。
Qt生态里主要有两个构建系统：qmake和CMake。
qmake：Qt的亲儿子
qmake是Qt官方最早推出的构建工具。它的配置文件是.pro文件，语法非常简洁。举个例子：
# 一个简单的qmake .pro文件
QT += core gui widgets
TARGET = MyApp
TEMPLATE = app
SOURCES += main.cpp \
mainwindow.cpp
HEADERS += mainwindow.h
FORMS += mainwindow.ui
看到没？几行就搞定了。qmake对Qt项目做了深度优化，你不需要关心MOC（元对象编译器）、UIC（UI编译器）、RCC（资源编译器）这些细节，qmake自动帮你处理。
我在项目中遇到过一个问题：有个同事用qmake配置了一个包含200多个源文件的项目，.pro文件也就几十行。换CMake的话，同样的配置可能要写上百行。这就是qmake的优势——对Qt项目来说，它是最省事的。
小提示：qmake的.pro文件支持条件判断，你可以根据不同的平台、编译模式写不同的配置。比如debug模式下加调试符号，release模式下优化代码。
CMake：行业标准
CMake不是Qt专属的，它是整个C++社区的事实标准。Qt从5.x开始逐步支持CMake，到Qt 6已经官方推荐使用CMake了。
CMake的配置文件是CMakeLists.txt，语法比qmake复杂一些，但功能更强大。看个例子：
cmake_minimum_required(VERSION 3.16)
project(MyApp VERSION 1.0.0 LANGUAGES CXX)
find_package(Qt6 REQUIRED COMPONENTS Core Gui Widgets)
set(SOURCES
main.cpp
mainwindow.cpp
)
set(HEADERS
mainwindow.h
)
set(FORMS
mainwindow.ui
)
qt_add_executable(MyApp ${SOURCES} ${HEADERS} ${FORMS})
target_link_libraries(MyApp PRIVATE
Qt6::Core
Qt6::Gui
Qt6::Widgets
)
CMake的优势在于：通用性强。你可以在一个项目里同时用Qt、Boost、OpenCV，CMake都能统一管理。而且CMake的生态非常丰富，很多第三方库都提供了CMake的查找模块。
注意：CMake的语法坑比较多。比如变量作用域、生成器表达式这些概念，新手很容易搞混。我曾经花了一整天调试一个CMake的变量传递问题，最后发现是作用域搞错了。
1.3 到底选qmake还是CMake？
这是每个Qt开发者都会面临的选择。我直接给结论：
| 场景 | 推荐 | 原因 |
|---|---|---|
| 纯Qt项目，团队小 | qmake | 配置简单，上手快，Qt特性支持好 |
| 大型项目，多模块 | CMake | 模块化管理强，第三方库集成方便 |
| 跨平台，多编译器 | CMake | 生成器支持广泛，VS/Xcode/Clang都能用 |
| Qt 6新项目 | CMake | 官方推荐，未来趋势 |
| 维护老项目 | 保持qmake | 迁移成本高，没必要折腾 |
我个人习惯是：新项目一律用CMake。原因很简单——你想想看，如果你的项目以后要集成第三方库，或者要支持CI/CD流水线，CMake的生态会让你省很多事。qmake虽然简单，但遇到复杂场景就捉襟见肘了。
不过话说回来，如果你只是做个个人小工具，或者团队里大家都习惯qmake，那用qmake完全没问题。工具是为人服务的，别为了用而用。
我的建议：如果你刚开始学Qt，先用qmake快速上手。等你对Qt项目结构熟悉了，再切换到CMake。别一上来就搞CMake，容易打击信心。
1.4 知识体系总览
下面这张图是我自己画的，帮你理清Qt构建系统的整体脉络：
这张图把Qt构建系统的核心要素都串起来了。你从上往下看：Qt框架在最上面，它依赖构建系统来编译；构建系统有两个选择——qmake和CMake；它们各自负责MOC处理、库管理、跨平台编译这些脏活；最后，你根据项目实际情况做选择。
嗯，这一章的内容就到这儿。记住一句话：没有最好的构建系统，只有最适合你项目的构建系统。下一章我们会深入qmake的.pro文件写法，到时候手把手带你写一个完整的项目配置。
个人经验：我曾经在一个项目里同时用了qmake和CMake——开发阶段用qmake快速迭代，发布阶段用CMake做自动化构建。虽然有点折腾，但效果还不错。不过这种玩法不推荐新手尝试。
可可精品资料库