CMake配置Qt项目的核心是让find_package找到Qt的Config.cmake文件；需将CMAKE_PREFIX_PATH设为Qt安装路径下含lib/cmake的父目录，而非子目录，并按Qt5/Qt6版本严格使用对应目标名和函数。
CMake 配置 Qt 项目的核心不是写一堆命令，而是让 find_package 找到 Qt 的 Qt5Config.cmake 或 Qt6Config.cmake —— 找不到，后面全白搭。
为什么 find_package(Qt5 REQUIRED) 总报错？
常见错误是：Could not find a package configuration file provided by "Qt5"。根本原因不是 Qt 没装，而是 CMake 根本没去对地方找。
- Qt 安装后，真正的配置文件（如
Qt5Config.cmake）在<Qt安装路径>/lib/cmake/Qt5/或<Qt安装路径>/lib/cmake/Qt5Widgets/下，不是根目录 -
CMAKE_PREFIX_PATH必须指向包含lib/cmake/的父目录，比如C:/Qt/5.15.2/msvc2019_64，而不是C:/Qt/5.15.2/msvc2019_64/lib/cmake - 如果用了多个 Qt 版本，别往系统 PATH 里加 Qt 的 bin；用
CMAKE_PREFIX_PATH显式指定，避免和Qt5_DIR缓存冲突 - Qt6 用户注意：
find_package(Qt6 REQUIRED COMPONENTS Widgets)是标准写法，Qt5::Widgets这种写法在 Qt6 中不推荐（应改用Qt6::Widgets）
CMAKE_AUTOMOC / AUTOUIC 开关到底要不要开？
开了能省事，但开了也容易掩盖头文件依赖问题。真实项目中建议开，但得知道它干了什么。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
set(CMAKE_AUTOMOC ON)：自动对含Q_OBJECT的.h文件调用moc，不用手动列moc_*.cpp到源文件里 -
set(CMAKE_AUTOUIC ON)：自动把.ui转成ui_*.h，但要求.ui文件必须出现在add_executable()的源文件列表中，否则不触发 -
set(CMAKE_AUTORCC ON)：同理，.qrc文件也得显式列进add_executable()，否则资源不打包 - Qt6 中这些开关默认为
ON（只要用了qt_add_executable），但 Qt5 仍需手动设
Windows 上 GUI 程序黑窗口怎么消失？
不是代码问题，是链接器设置。控制台窗口出现，说明入口点还是 main，而 GUI 应该用 WinMain。
- Qt5 项目：加
set(CMAKE_WIN32_EXECUTABLE ON)即可，CMake 会自动加/SUBSYSTEM:WINDOWS和替换入口点 - Qt6 项目：用
qt_add_executable(... WIN32)替代add_executable()，这是 Qt6 官方推荐方式 - 如果用了
set(CMAKE_WIN32_EXECUTABLE ON)却仍弹黑窗，检查是否漏了target_link_libraries(... Qt5::WinMain)（Qt5）或Qt6::WinMain（Qt6） - VS 用户注意：CMakePresets.json 里若没设
"configuration": "Debug"或"configuration": "Release"，VS 可能默认走控制台构建逻辑
最常被忽略的其实是 Qt 版本与 CMakeLists.txt 的耦合点：Qt5 要求 find_package(Qt5 ...) + Qt5::* 目标名，Qt6 要求 find_package(Qt6 ...) + Qt6::*，混用会导致链接失败且错误信息极不直观。别图省事写成 Qt::Widgets 就以为能通用——只有在同时适配 Qt5/Qt6 的复杂项目里才值得引入这种抽象，日常开发请严格按实际版本写死。
