Macbook 安装Cmake

macOS 默认不把 GUI 应用里的命令行工具纳入 PATH
M1/M2/M3 芯片 隔离

三种解决 适用场景和坑点

Homebrew 安装

最快、最省心 但要注意芯片架构 Homebrew 自动处理路径、权限和依赖
Apple Silicon 用户必须确认用的是原生 ARM 版 Homebrew（路径为 /opt/homebrew/bin）
否则可能因架构不匹配导致后续构建失败。

先验证 Homebrew 是否原生
which brew
输出应为
/opt/homebrew/bin/brew
若为
/usr/local/bin/brew
是 Rosetta 2 兼容版建议重装

执行
brew install cmake
会把 cmake 二进制文件放至
/opt/homebrew/bin/cmake（M1/M2）
或
/usr/local/bin/cmake（Intel）

无需手动改
~/.zshrc

Homebrew 安装后已自动前置该路径到 $PATH
但如果你之前手动改过 PATH
可能被覆盖

运行
echo $PATH | grep homebrew
确认

cmake --version
应直接输出版本号
比如 cmake version 3.29.2

DMG 拖拽安装后配置 PATH

GUI 用户常用 但容易漏掉关键步骤 官网下载的 .dmg 文件本质是 CMake.app 应用包
命令行工具藏在
/Applications/CMake.app/Contents/bin/

终端找不到命令 因为系统没被告知去这个目录找 cmake
CMake GUI 的 “How to Install For Command Line Use” 菜单（Tools > How to Install For Command Line Use）
弹出含完整命令的对话框

手动配置时
必须根据 shell 类型选对配置文件
echo $SHELL
返回
/bin/zsh
就改
~/.zshrc
返回
/bin/bash
就改 ~/.bash_profile
写入的这行不能少
export PATH=“/Applications/CMake.app/Contents/bin:$PATH”
注意 $PATH 在右边 否则会覆盖系统原有路径
source ~/.zshrc
用
which cmake
输出
/Applications/CMake.app/Contents/bin/cmake
再跑 cmake --version

源码编译安装可控性强

但容易卡在 bootstrap 阶段 适合需要定制编译选项 禁用 Qt GUI、启用 Ninja 支持 调试 CMake 本身、或部署到无网络环境的场景 对开发环境要求更高
./bootstrap
这一步最容易失败
必须先装 Xcode 命令行工具
xcode-select --install
确保
clang --version
有输出
否则 bootstrap 会报 “no acceptable C compiler found”
./bootstrap --prefix=/usr/local --parallel=$(sysctl -n hw.ncpu) 是关键
不加 --prefix 默认装到 /usr/local
而该路径已在系统 PATH 中；加了 --parallel 能加速编译
避免在 M 系列芯片上只用单核
编译前检查磁盘空间 —— make 过程中临时文件可能达 2GB+
/tmp 分区不够会静默失败
最后一步 sudo make install 成功后
cmake 就在 /usr/local/bin/cmake
无需额外 PATH 设置
真正容易被忽略的
是 PATH 冲突
比如你用 Homebrew 装了 CMake
又手动往 ~/.zshrc 里加了一条指向 DMG 版本的 PATH
结果 which cmake 显示的是旧版本
但 cmake --version 却报错 —— 这种路径叠加混乱在 Apple Silicon 上特别常见
建议每次安装后都用 which cmake 和 echo $PATH 双重验证实际生效的是哪个路径。