Qt Creator安装时无需配置CMake路径，首次启动后需手动在“工具→选项→CMake→工具”中添加CMake可执行路径，并在Kit中显式绑定对应Qt版本与CMake工具，否则新建项目会报CMake not found或找不到Qt模块。

Qt Creator安装时根本不用配CMake

Qt Creator 安装器本身不负责配置 CMake 路径，它只管把 Qt Creator 可执行文件、内置工具链和默认 Kits 放到位。真正影响 CMake 是否能用的，是 Qt 安装包里带的 CMake 模块、你本地是否装了独立 CMake、以及 Qt Creator 启动后在 Kits 里手动选的编译器与 CMake 版本组合。

CMake 路径必须在 Qt Creator 首次启动后设置

安装完直接打开 Qt Creator，它不会自动识别你系统 PATH 里的 CMake，也不会读取 Qt 自带的 CMake（哪怕你勾选了“CMake Tools”组件）。必须手动指定：

CMake 4.3.2

CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。

下载

• 进入 工具 → 选项 → CMake → 工具（Tools），点击 + 添加一个 CMake 可执行路径
• 推荐优先用 Qt 安装目录下的 CMake：C:\Qt\Tools\CMake_64\bin\cmake.exe（Windows MinGW 场景）或 C:\Qt\Tools\QtCreator\bin\cmake\bin\cmake.exe（Qt Creator 自带版本）
• 如果已单独安装 CMake 且版本 ≥ 3.22，也可指向 C:\Program Files\CMake\bin\cmake.exe，但需确认它支持你选的编译器（比如 MSVC 2022 需 CMake ≥ 3.21）
• 添加后，记得在 Kit 页里为每个 Kit 显式绑定这个 CMake 工具——否则新建项目仍会报 CMake not found

Kit 里 CMake 配置错位会导致“找不到 Qt 模块”

常见现象是 CMake configure 阶段报错：find_package(Qt6Widgets REQUIRED) failed 或 Could NOT find Qt6 (missing: Widgets)。这不是 CMake 路径问题，而是 Kit 的 Qt 版本没对上 CMake 查找逻辑：

• 确保 Kit 的 Qt version 下拉框里选的是你实际安装的 Qt 版本（如 Qt 6.7.2 MinGW 64-bit），不是“None”或空项
• 该 Qt 版本必须包含 CMake 配置模块：检查对应安装路径下是否存在 lib/cmake/Qt6/Qt6Config.cmake（Qt6）或 lib/cmake/Qt5Widgets/Qt5WidgetsConfig.cmake（Qt5）
• 若使用自定义 CMake 路径，且 Qt 安装路径含空格或中文，CMAKE_PREFIX_PATH 参数必须用双引号包裹，例如：-DCMAKE_PREFIX_PATH="C:/Qt/6.7.2/mingw_64"

新建 CMake 项目时容易漏掉 AUTOMOC/AUTOUIC

Qt 的 .ui 和 .qrc 文件不会自动参与构建，除非 CMakeLists.txt 显式启用 Qt 特性支持。即使 Qt Creator 创建模板时默认写了，也常被新手删掉或注释：

• 必须在 find_package 之后、add_executable 之前加这三行：

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

• Qt6 推荐改用 qt_add_executable 替代 add_executable，它会自动处理 MOC/UIC/RCC，但前提是 find_package(Qt6 REQUIRED COMPONENTS Widgets) 成功且版本 ≥ 6.5
• 如果用了 set(CMAKE_AUTOMOC ON) 却仍报 moc_*.cpp not found，大概率是源文件没加到 add_executable 列表里，或者头文件没声明 Q_OBJECT

CMake 配置真正的难点不在安装那一刻，而在于 Kit、Qt 版本、CMake 可执行文件、CMAKE_PREFIX_PATH 这四者之间的隐式耦合——任何一个环节路径写错、版本不匹配、或未在 Kit 中显式关联，都会让 configure 直接失败，且错误信息往往不指明具体缺哪一环。