qt creator 找不到 cmake 是因未在工具链中注册已安装的 cmake 路径，需通过 tools → options → kits → cmake 手动添加绝对路径并绑定到 kit，同时注意版本兼容性与环境变量干扰。

Qt Creator 找不到 cmake，本质是它没在配置里“认出”你系统里已安装的 cmake 可执行文件——不是没装，而是没注册进 Qt Creator 的工具链体系。

确认 cmake 是否真已安装且可用

别跳过这步。Qt Creator 不读系统 $PATH（尤其 Linux/macOS），但命令行能跑不代表它能用。

• 终端执行 cmake --version，确认输出类似 cmake version 3.21.4；低于 3.14 可能触发 Qt Creator 文件 API 兼容问题
• 执行 which cmake（Linux/macOS）或 where cmake（Windows CMD），拿到绝对路径，比如 /usr/bin/cmake 或 C:\Program Files\CMake\bin\cmake.exe
• 如果命令报错，先装 cmake：Linux 用 sudo apt install cmake（Ubuntu/Debian）或 brew install cmake（macOS）；Windows 推荐从 cmake.org 下载安装包，勾选「Add CMake to the system PATH」

在 Qt Creator 中手动注册 cmake 路径

Qt Creator 管自己的工具列表，必须显式添加。GUI 操作比改 XML 安全得多。

CMake 4.3.2

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

下载

• 打开 Tools → Options → Kits → CMake
• 点击右上角 + 添加新条目
• Name 填个易识别的名，比如 CMake 3.21 (system)
• Path 栏粘贴刚才 which cmake 得到的完整路径；Windows 注意路径含空格时不用引号，Qt Creator 会自动处理
• 点 Apply，此时列表里应出现你刚加的条目

检查 Kit 是否绑定了正确的 CMake 配置

即使 cmake 路径注册了，Kit 还可能用着旧的、失效的或空的配置。

• 切换到 Kits 标签页，选中你正在用的 Kit（如 Desktop Qt 6.5.3 GCC 64bit）
• 看右侧 CMake tool 下拉框：如果显示 <none></none> 或名字灰显，说明没绑定；从下拉菜单里选你刚注册的那个 CMake 3.21 (system)
• 点 Apply，再点 OK 退出设置
• 重启 Qt Creator（尤其 Linux/macOS 下，有时缓存不刷新）

常见坑点：Linux 下 LD_LIBRARY_PATH 干扰

如果你在 ~/.bashrc 里设过 LD_LIBRARY_PATH 指向某个 Qt 版本的 lib/，Qt Creator 启动时可能加载错位的库，导致界面卡死或 CMake 配置失败，错误日志里常带 undefined symbol。

• 临时验证：终端里先 unset LD_LIBRARY_PATH，再运行 qtcreator，看是否正常
• 根治方法：注释掉 ~/.bashrc 里所有 LD_LIBRARY_PATH 相关行，Qt Creator 自带运行时库足够用
• 需要环境变量时，只在构建脚本里局部设置，别全局污染

最麻烦的不是找不到 cmake，而是它找到了但版本太低、路径被覆盖、或和 Qt SDK 的 ABI 不匹配——所以每次换 Qt 版本或升级 cmake 后，都得重新核对 Kit 绑定状态。