CMake安装需确保PATH配置正确、版本达标且路径无中文。Windows必须勾选“Add to PATH”，Linux避免apt旧版推荐官方二进制包，macOS用Homebrew并检查shell PATH，装完须验证cmake --version及构建工具链是否就绪。
CMake 安装不是“下载点下一步”就完事——PATH 没配对、版本太旧、路径含中文，三者任一出错，cmake --version 就会报错或根本找不到命令。
Windows 上安装 CMake 必须勾选「Add to PATH」
官网下载 .msi 安装包后，安装向导里有个不起眼但致命的复选框：Add CMake to the system PATH for all users。不勾它，哪怕安装成功，CMD/PowerShell 里输入 cmake --version 也会提示“不是内部或外部命令”。
- 勾选后，CMake 二进制路径（通常是
C:\Program Files\CMake\bin）会被写入系统环境变量PATH - 安装完成后必须重启终端（CMD/PowerShell/VS Code 终端），否则新
PATH不生效 - 验证方式：新开终端，直接运行
cmake --version，看到类似cmake version 3.28.2才算真正可用
Linux 用 apt 安装常因版本过低失败
Ubuntu/Debian 默认源里的 cmake 版本往往卡在 3.16 或更低，而现代项目（如 Detectron2、modern C++ 库）普遍要求 ≥3.20。直接 sudo apt install cmake 很可能装了个不能用的旧版。
- 先查当前版本：
cmake --version，若低于3.20，别硬扛 - 推荐方案：用官方二进制包（免编译、秒装）
下载最新.tar.gz（如cmake-3.28.1-linux-x86_64.tar.gz），解压后把bin/cmake软链接到/usr/local/bin/：sudo ln -sf $PWD/cmake-3.28.1-linux-x86_64/bin/cmake /usr/local/bin/cmake - 避免用
./bootstrap && make编译源码——耗时长、依赖多、容易因python或openssl版本不匹配中断
macOS 上 Homebrew 是最稳路径
brew install cmake 能自动处理依赖和 PATH，但有两个隐藏坑：
- 如果
which cmake返回空，说明brew的 bin 目录没进PATH；检查 shell 配置文件（~/.zshrc或~/.bash_profile），确保有export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel） - 升级时别用
brew upgrade cmake直接覆盖——某些项目锁定了 CMake 版本，升级后cmake ..可能报version not supported；稳妥做法是保留旧版并用cmake-3.20这类带版本号的命令显式调用
CMake 安装后第一件事：验证构建器是否就位
装完 cmake 不等于能编译项目。cmake .. 报错 CMake was unable to find a build program，90% 是因为没装对应平台的构建工具链。
- Windows：必须已安装 Visual Studio（含“C++ build tools”）或 MinGW-w64；仅装 CMake 不行
- Linux：确认
make和g++已就绪：make --version、g++ --version都得有输出；缺则sudo apt install build-essential - macOS：运行
xcode-select --install安装命令行工具；仅靠 Xcode GUI 不够
真正的安装完成，是 cmake --version 和 cmake -E echo "OK" 都能立刻返回结果，且后续能跑通一个最小 CMakeLists.txt（哪怕只含 project(test)）。
