cmake在windows 11安装失败主因是path未生效或漏选“add cmake to the system path”选项;必须勾选该选项、新开终端验证cmake --version,或用winget install kitware.cmake更省事。

cmake 在 Windows 11 上安装失败,绝大多数情况不是版本问题,而是 PATH 没生效或安装时漏选关键选项。直接装对版本、勾对选项、验证方式正确,5 分钟内就能用上。
安装时必须勾选 “Add CMake to the system PATH”
这是最常被忽略的一步。哪怕你用的是最新版 cmake-3.29.0-windows-x86_64.msi,如果没勾这个选项,cmake --version 就会报“不是内部或外部命令”。
注意:安装界面里有两个相似选项:
- Add CMake to the system PATH for all users(推荐,全局可用)
- Add CMake to the system PATH for current user(仅当前账户生效)
用 winget 安装更省事,且默认 PATH 正确
Windows 11 自带 winget,不用下载 MSI,命令执行完就能用:winget install Kitware.CMake
它会自动把 cmake.exe 装到系统路径(通常是 C:\Program Files\WindowsApps\Kitware.CMake_*\bin),并注册进 PATH。验证只需:cmake --version
输出类似 cmake version 3.29.0 即可。比手动 MSI 安装还少一步重启终端。
CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
验证时别只信 GUI,要跑 CLI 命令
很多人点开 cmake-gui.exe 能用,就以为装好了——其实 GUI 和 CLI 是两个独立程序。
真正影响构建流程的是命令行版 cmake.exe,所以必须在终端里运行:where cmake(确认路径存在)cmake --version(确认可执行)
如果 where cmake 无输出,说明 PATH 没生效;如果提示权限错误,可能是安装被杀毒软件拦截过,重装时关掉实时防护。
装完仍报错?先查是不是多版本冲突
Windows 11 用户容易遇到多个 cmake 共存:比如 Qt 自带的、vcpkg 提供的、MSYS2 里的、还有手动装的。
执行:Get-Command cmake | ForEach-Object {$_.Path}(PowerShell)
或where cmake(CMD)
看输出的路径是否指向你刚装的版本。如果指向 C:\Qt\Tools\CMake\bin\cmake.exe 这类第三方路径,就说明 PATH 顺序错了——把官方安装路径(如 C:\Program Files\CMake\bin)往前挪,或者删掉干扰项。










