Windows用户应选cmake-x.x.x-windows-x86_64.msi安装包,它自动配置PATH并支持卸载;Linux用户优先用预编译tar.gz包并确保英文路径;macOS用户推荐brew install cmake;所有平台安装后须在新终端中验证cmake --version。

CMake安装包选错,cmake --version 就会报“不是内部或外部命令”——根本不是版本问题,是PATH没生效或二进制不兼容。
Windows用户直接选 cmake-x.x.x-windows-x86_64.msi
这是绝大多数人的正确答案。64位Windows(Win10/11)占绝对主流,cmake-4.3.3-windows-x86_64.msi 这类安装包自带图形向导、自动注册PATH、支持卸载,且默认勾选“Add CMake to the system PATH for all users”。
- 别碰
i386包,除非你确认系统是32位(现在极少见) - 别下
.zip包除非你明确需要便携部署(比如U盘开发),否则要手动配PATH,容易漏掉 - MSI安装后必须重启终端(CMD/PowerShell)才能识别PATH,不是“立刻生效”
Linux用户优先用预编译 .sh 或 .tar.gz 包
源码编译纯属浪费时间——CMake本身不依赖复杂环境,官方提供的 cmake-4.3.3-linux-x86_64.tar.gz 解压即用。
- 解压后路径里含空格或中文会导致
cmake --version失败,务必用纯英文路径(如/opt/cmake-4.3.3) - 软链接要指向
bin/cmake,不是整个目录:ln -sf /opt/cmake-4.3.3/bin/cmake /usr/local/bin/cmake - Ubuntu/Debian建议用
apt install cmake,但版本通常滞后(比如只到3.22),不适合需要新语法(如target_link_options())的项目
macOS用户别绕路,Homebrew一条命令搞定
brew install cmake 是最稳的选择。它自动处理符号链接、权限和PATH,且升级方便:brew upgrade cmake。
- 如果用官网PKG安装,需确认是否勾选了“Add to PATH”,macOS的PATH机制和Linux不同,有时需要手动改
~/.zprofile - Apple Silicon(M1/M2/M3)机器选
arm64包,x86_64包能跑但可能触发Rosetta翻译开销 - 不要用MacPorts或手动编译,除非你明确在调试CMake自身源码
验证安装时最容易忽略的三个点
装完不验证等于没装;验证方式不对,等于白验证。
- 在全新打开的终端里运行
cmake --version,不是复用旧窗口——PATH变量不会热更新 - 输出里带
kitware.com/cmake才算正版,第三方打包(比如某些Linux发行版仓库)可能阉割功能 - 如果看到
command not found但文件明明存在,检查是否误把cmake软链接指向了目录而非可执行文件


















