windows用户应下载cmake-*.windows-x86_64.msi安装包,安装时务必勾选“add cmake to the system path”,并重启终端验证cmake --version是否正常输出版本号。

Windows 用户直接下 cmake-*.windows-x86_64.msi 就行,别选 ZIP 或 i386,除非你明确知道自己在用 32 位系统或需要便携部署。
怎么选对安装包?看清楚后缀和系统位数
官网下载页(https://cmake.org/download/)里 Windows 区域有三类常见包:
-
cmake-*.windows-x86_64.msi:64 位 Windows 标准安装包,带图形向导、自动加 PATH、能卸载——绝大多数人该选它 -
cmake-*.windows-i386.msi:仅限 32 位 Windows,现在极少见,装了也大概率报错“无法启动此程序” -
cmake-*.windows-x86_64.zip:纯解压版,不改注册表、不写 PATH,适合临时用或没管理员权限,但后续得手动配Path环境变量
别被“Universal”“Latest”这类词带偏,重点盯住 x86_64 和 .msi 这两个标识。
安装时必须勾选 “Add CMake to the system PATH”
这一步漏掉,cmake --version 在 CMD 或 PowerShell 里就直接报“不是内部或外部命令”。MSI 安装向导第三步或第四步会出现这个复选框,务必打勾——它会把 C:\Program Files\CMake\bin(或你自定义的安装路径下的 bin 目录)写进系统环境变量。
如果不小心跳过了:
- 打开“系统属性 → 高级 → 环境变量”,在“系统变量”里找到
Path,点“编辑”→“新建” - 填入你安装目录下的
bin路径,比如F:\cmake\bin或C:\Program Files\CMake\bin - 重启所有已打开的终端窗口,否则 PATH 不生效
验证是否真装好了?别只信“Finish”按钮
点完 Finish 不代表能用。打开一个新的 CMD 或 PowerShell 窗口,执行:
cmake --version
如果返回类似 cmake version 4.3.0,说明 PATH 和二进制都正常;如果提示“找不到命令”,回头检查上一步的 PATH 是否写错路径、是否漏重启终端。
顺带测试生成器是否可用(尤其你打算配合 Visual Studio):
cmake -G "Visual Studio 17 2022" -A x64 -B build
只要不报 No CMAKE_C_COMPILER could be found 这类错误,基础环境就算过关。这个错误通常不是 CMake 的问题,而是没装 VS 或没勾选“C++ CMake 工具”组件。
真正容易卡住的地方不是下载或点击 Next,而是 PATH 没生效、终端没重启、或者误以为装了 CMake 就等于装了编译器——CMake 只是构建生成器,CMAKE_C_COMPILER 还得靠 Visual Studio、MinGW 或 Clang 自己提供。











