Qt项目CMake构建核心是找对Qt、开启自动处理、正确链接库；常见错误是find_package找不到配置文件，需设CMAKE_PREFIX_PATH或Qt_DIR；AUTOMOC/AUTOUIC/AUTORCC须按需开启且顺序正确；add_executable须显式包含.ui/.qrc；target_link_libraries必须用Qt5::Widgets等目标名而非变量名。
Qt 项目用 CMake 构建，核心就三件事：找对 Qt、打开自动处理、连上库。其他都是围绕这三点的路径或版本适配问题。
find_package 怎么写才不报错
常见错误是 find_package(Qt5Widgets REQUIRED) 失败，提示 “Could not find a package configuration file”，本质是 CMake 不知道 Qt 装在哪。
- 最稳妥的方式是显式设置
CMAKE_PREFIX_PATH，比如 Windows 上 MinGW 编译器对应路径：set(CMAKE_PREFIX_PATH "C:/Qt/5.15.2/mingw81_64")（注意斜杠方向，Windows 下也建议用正斜杠） - Qt6 开始推荐用
find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets)+find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Widgets)，靠变量自动切换版本，避免硬编码 - 别只写
find_package(Qt5 REQUIRED)—— 这样不会导入模块路径，后续target_link_libraries用Qt5::Widgets仍会失败 - 如果用的是 Qt 官方在线安装器，默认路径在
C:/Qt/下按版本+编译器命名，例如5.15.2/msvc2019_64，不是Qt5.15.2
CMAKE_AUTOMOC / AUTOUIC / AUTORCC 开关必须开吗
不是“可选”，而是“按需强制开启”——只要代码里用了 Q_OBJECT、.ui 或 .qrc，对应开关就必须 ON，否则编译直接失败或运行时崩溃。
-
set(CMAKE_AUTOMOC ON)：没它，带Q_OBJECT的类无法生成 moc 文件，链接时报 undefined reference 到qt_static_plugin_QWindowsIntegrationPlugin这类符号 -
set(CMAKE_AUTOUIC ON)：UI 文件不自动转成ui_mainwindow.h，#include "ui_mainwindow.h"就会报错 -
set(CMAKE_AUTORCC ON)：资源文件（.qrc）不编译进二进制，图片/翻译等全丢，界面空白或文字缺失 - 这三个开关必须放在
find_package之后、add_executable之前，顺序错会导致部分文件不被识别
add_executable 怎么列文件才不出错
很多人把 .ui 和 .qrc 文件漏掉或放错位置，导致构建成功但运行异常。
-
add_executable(myapp main.cpp mainwindow.cpp mainwindow.h mainwindow.ui resources.qrc)——.ui和.qrc必须和源码一起传给add_executable()，不能只列 .cpp - 不要用
file(GLOB)自动收所有.h：CMake 不会自动识别头文件是否含Q_OBJECT，导致 moc 失效；.h只有被.cpp显式#include且含宏时才参与 moc，所以手动列更稳 - Qt6 推荐用
qt_add_executable()替代add_executable()，它内置了对 Qt 特有文件的支持逻辑，尤其在 Android/iOS 平台更可靠 - Windows 下若不想弹黑窗口，加一句：
set_target_properties(myapp PROPERTIES WIN32_EXECUTABLE TRUE)
target_link_libraries 写法差异和陷阱
链接写错最典型症状是：编译过、链接过、一运行就崩溃，报 undefined symbol: _ZN7QWidgetD2Ev 这类 mangled 名字。
- 必须用
Qt5::Widgets（Qt5）或Qt6::Widgets（Qt6），不能写Qt5Widgets或Qt5Widgets_LIBRARY—— 后者只是变量名，不是 target 名 - 推荐用
PRIVATE修饰符：target_link_libraries(myapp PRIVATE Qt${QT_VERSION_MAJOR}::Widgets)，避免把 Qt 的 include 路径透传给依赖你的其他 target - 如果用了多个模块（比如 Widgets + Core + Gui），每个都要单独
find_package，然后全部列进target_link_libraries，Qt 不会自动补全依赖链 - Qt6 中
Qt6::Core不再隐式包含Qt6::Gui，缺了find_package(Qt6 COMPONENTS Gui)就可能在调用QPixmap时链接失败
真正容易被忽略的是：CMake 配置缓存不清理就改 CMAKE_PREFIX_PATH 或 find_package 参数，旧路径还在 cache 里，怎么改都不生效。每次调大改小 Qt 版本或编译器，先删掉 build/ 目录再重新 configure。
