find_package(qt6)失败的根本原因是cmake无法定位qt6config.cmake文件，必须通过set(cmake_prefix_path "d:/qt/6.6.2/mingw_64")等精确路径告知cmake搜索位置，且路径需与所选kit（mingw/msvc）严格匹配，同时确保无空格中文路径、c++17标准一致、模块名使用qt6::widgets等命名空间语法。
Qt6 + CMake 在 Windows 上能跑起来，关键不在 CMake 本身，而在 Qt 工具链和 CMakeLists.txt 的绑定是否精准——错一个路径或模块名，find_package 就直接报错退出。
为什么 find_package(Qt6) 总失败？
根本原因不是 Qt 没装，而是 CMake 根本找不到 Qt6 的配置文件（Qt6Config.cmake）。它默认只在标准系统路径查，而 Qt 安装后实际位置是：D:/Qt/6.6.2/mingw_64 或 D:/Qt/6.6.2/msvc2019_64 这类自定义路径。
- 必须显式告诉 CMake 去哪找：在
CMakeLists.txt顶部加set(CMAKE_PREFIX_PATH "D:/Qt/6.6.2/mingw_64")（路径按你实际安装改） - 不能写成
set(CMAKE_PREFIX_PATH "D:/Qt/6.6.2")—— 缺少子目录会导致find_package找不到模块 - 如果用 MSVC 编译器，
CMAKE_PREFIX_PATH必须指向msvc2019_64目录，不是mingw_64；混用会链接失败 - Qt Creator 或 VSCode 中选错 Kit（比如选了 MinGW Kit 却配了 MSVC 的
CMAKE_PREFIX_PATH），也会触发同样错误
target_link_libraries 该写 Qt6::Widgets 还是 Qt6Widgets？
Qt6 强制要求使用命名空间语法：Qt6::Widgets。写成 Qt6Widgets 或 Qt6Widgets_LIBRARIES 会编译失败，报 target_link_libraries called with incorrect number of arguments。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 模块名必须全小写、双冒号分隔：
Qt6::Core、Qt6::Gui、Qt6::Widgets - 多个模块用空格分隔：
target_link_libraries(myapp PRIVATE Qt6::Core Qt6::Widgets) -
PRIVATE是推荐作用域——对外不暴露 Qt 依赖，避免下游项目链接污染 - 如果用了
Q_OBJECT宏或 UI 文件，set(CMAKE_AUTOMOC ON)和set(CMAKE_AUTOUIC ON)必须开启，否则 moc/ui 头文件不会自动生成
MinGW 和 MSVC 的 CMAKE_CXX_STANDARD 要一致吗？
要，而且必须匹配 Qt 库的编译标准。Qt6 官方预编译包统一用 C++17，所以你的项目也得设为 17。
- 写
set(CMAKE_CXX_STANDARD 17)，别写14或20—— 否则可能触发 ABI 不兼容，运行时崩溃 - MSVC 工具链下，
set(CMAKE_CXX_STANDARD_REQUIRED ON)更稳妥，强制拒绝降级 - MinGW-w64 13.x 支持 C++17 没问题；但老版本（如 7.3）可能不支持，此时需换 Qt5 或升级 MinGW
- Qt Creator 中 Kit 的编译器版本（如 MinGW 13.1）必须和
CMAKE_PREFIX_PATH下的 Qt 子目录名（mingw1310_64）严格对应，否则头文件和库版本错位
最容易被忽略的是：Qt 安装路径里有空格或中文时，CMAKE_PREFIX_PATH 会被 CMake 解析失败，连带整个 find_package 报错。哪怕只是路径里有个“Program Files”，也得换成短路径（如 C:/Qt/...）或用双引号包裹——但 Qt 官方明确建议全程英文无空格路径，这是硬性前提，不是可选项。
