CMake找不到Qt6的根本原因是Qt6_DIR路径未精确指向含Qt6Config.cmake的lib/cmake/Qt6目录，而非Qt未安装；该文件必须位于Qt安装路径/版本/编译器/lib/cmake/Qt6/下，设为根目录或遗漏“CMake toolchain files”组件均会导致失败。
CMake找不到Qt，不是Qt没装，而是它根本没机会看到Qt——路径没给对，或者给错了地方。
Qt6_DIR必须精确到lib/cmake/Qt6目录
Qt6的CMake模块依赖Qt6Config.cmake文件，它只存在于Qt安装路径/版本/编译器/lib/cmake/Qt6/下，比如C:\Qt\6.7.2\msvc2022_64\lib\cmake\Qt6\Qt6Config.cmake。设Qt6_DIR为根目录（如C:\Qt\6.7.2\msvc2022_64）是常见错误，CMake会去那里找Qt6Config.cmake，但实际它在子目录里。
- 验证命令：
ls $Qt6_DIR/lib/cmake/Qt6/Qt6Config.cmake（Linux/macOS）或dir %Qt6_DIR%\lib\cmake\Qt6\Qt6Config.cmake（Windows），必须返回该文件 - 若用命令行配置：加
-DQt6_DIR="C:/Qt/6.7.2/msvc2022_64/lib/cmake/Qt6"，注意路径结尾不含斜杠 - Qt Online Installer安装时，务必勾选“CMake toolchain files”组件，否则
lib/cmake/Qt6目录压根不会生成
Qt5用CMAKE_PREFIX_PATH更可靠
Qt5的find_package(Qt5)默认不认Qt5_DIR，而是优先查CMAKE_PREFIX_PATH下的lib/cmake/Qt5。直接设Qt5_DIR反而容易被忽略。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 推荐方式：命令行运行
cmake -DCMAKE_PREFIX_PATH="C:/Qt/5.15.2/msvc2019_64" .. - Windows下环境变量
CMAKE_PREFIX_PATH值应为完整Qt安装路径（不含lib/cmake），不是Qt5_DIR - 检查Qt5安装完整性：
C:/Qt/5.15.2/msvc2019_64/lib/cmake/Qt5/Qt5Config.cmake必须存在，缺失说明安装时漏选了开发组件
PATH和QTDIR只是辅助，不能替代显式路径
PATH影响qmake或windeployqt等工具调用，QTDIR仅被部分旧脚本读取，CMake本身基本不看这两个变量。依赖它们等于把关键路径交给运气。
- VS2022环境下，即使
PATH含C:\Qt\6.7.2\msvc2022_64\bin，CMake仍会报Could not find Qt6Config.cmake - Qt Creator中Kit设置里的“Qt version”选对了，不代表CMake能找到——Kit和CMake是两套独立路径查找逻辑
- 跨版本共存时（如Qt5.15和Qt6.7），
QTDIR指向哪个版本，qmake就用哪个，但CMake仍需单独指定Qt6_DIR或CMAKE_PREFIX_PATH
CMake调试输出比猜错因更有效
加--debug-find参数让CMake打印所有搜索路径，比反复改环境变量快得多。
- 执行
cmake -B build --debug-find ..，观察日志里find_package(Qt6)实际搜了哪些路径 - 常见失败线索：“Searching
C:/Qt/6.7.2/msvc2022_64/lib/cmake/Qt6”后跟“no file”——说明Qt6_DIR设对了但文件真缺失；若根本没出现这个路径，说明变量没传进去 - Linux/macOS注意路径大小写：
/opt/Qt/6.7.2和/opt/qt/6.7.2是两个不同路径，CMake严格区分
最常被忽略的点：Qt安装时组件勾选不全，导致lib/cmake目录为空。重装Qt并确认勾选“CMake toolchain files”或对应“Sources”组件，比调半天环境变量管用得多。
