Homebrew是macOS安装CMake的首选方案，因其自动配置PATH、无需手动编辑环境变量、支持自动升级；Apple Silicon默认装至/opt/homebrew/bin，Intel装至/usr/local/bin，安装后运行cmake --version即可验证。
直接用 brew install cmake 就行，90% 的 macOS 用户该选这个。其他方式要么多一步配置、要么容易 PATH 失效，不推荐作为默认方案。
为什么 Homebrew 是首选
Homebrew 安装的 cmake 默认落在 /opt/homebrew/bin/cmake（Apple Silicon）或 /usr/local/bin/cmake（Intel），这两个路径通常已存在于 shell 的 PATH 中。安装完就能立刻用，不用额外改配置文件。
- 验证是否生效：终端运行
cmake --version，有输出即成功 - 如果提示
command not found，大概率是 shell 初始化文件没加载 Homebrew 路径，检查~/.zshrc或~/.bash_profile里有没有这行：eval "$(/opt/homebrew/bin/brew shellenv)" - Homebrew 安装的
cmake会自动随brew upgrade更新，不用手动下载新版本
官网 DMG 安装后命令不可用怎么办
拖拽 CMake.app 到 /Applications 后，cmake 命令默认不可用——因为它的可执行文件藏在 /Applications/CMake.app/Contents/bin/cmake，不在系统 PATH 里。
- 临时解决：运行
/Applications/CMake.app/Contents/bin/cmake --version - 长期解决：把那个目录加进
PATH，比如在~/.zshrc里加一行：export PATH="/Applications/CMake.app/Contents/bin:$PATH" - 注意：每次更新 CMake.app，路径不变，但如果你删了重装，得确认路径是否仍为
Contents/bin；某些旧版可能用Resources/bin
MacPorts 或手动编译安装的坑
MacPorts 的 cmake 通常装在 /opt/local/bin/cmake，需要确保该路径在 PATH 前置位，否则可能和 Homebrew 版本冲突；手动编译则必须自己指定 --prefix，且极易因 SIP 保护写不到 /usr 下。
- MacPorts 用户务必检查
which cmake输出，避免意外调用到系统自带的极老版本（macOS 自带的/usr/bin/cmake通常是 3.20 之前的老版本） - 手动编译时别用
--prefix=/usr，会被 SIP 拦住；建议用--prefix=/usr/local或--prefix=$HOME/local - 无论哪种源码安装，记得运行
sudo make install后再检查权限：ls -l $(which cmake)，确保当前用户有执行权
真正麻烦的不是装不上，而是装了多个版本又没理清 PATH 优先级。先跑 which cmake 和 cmake --version 确认实际调用的是哪个，比反复重装更省时间。
