答案是CMake命令未被终端识别，根本原因是其可执行文件路径未加入PATH环境变量；官网DMG安装的cmake实际位于/Applications/CMake.app/Contents/bin/，需手动将其添加至~/.zshrc并source生效，或改用Homebrew自动配置。
装完 CMake 后在 macOS 上用不了，基本就是 cmake 命令没进 PATH —— 不是没装好，是终端根本找不到它。
为什么 cmake --version 报错 “command not found”
从官网下载的 .dmg 安装包，本质是图形应用 CMake.app，可执行文件实际藏在：/Applications/CMake.app/Contents/bin/cmake
但 macOS 终端默认只查 /usr/bin、/usr/local/bin 这类路径，不会主动翻进 App 包里找命令。
所以你拖完图标、双击安装完，cmake 依然不可用，是正常现象。
- 验证方式：直接运行
/Applications/CMake.app/Contents/bin/cmake --version，如果能输出版本号，说明二进制本身完好 - 别试
which cmake，它肯定返回空 —— 这正是问题所在 - Apple Silicon（M1/M2/M3）芯片无额外兼容问题，路径逻辑和 Intel Mac 完全一致
三种让 cmake 可用的实操路径
核心目标只有一个：把 /Applications/CMake.app/Contents/bin 加进你的 shell 的 PATH。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
推荐 Homebrew 方式：运行
brew install cmake，它自动把cmake装到/opt/homebrew/bin/cmake（Apple Silicon）或/usr/local/bin/cmake（Intel），且该路径默认已在PATH中，装完即用 -
DMG 安装后手动加 PATH：编辑
~/.zshrc（macOS Catalina 及以后默认 shell 是 zsh），追加一行：export PATH="/Applications/CMake.app/Contents/bin:$PATH"
然后运行source ~/.zshrc -
用官方提供的安装脚本：终端执行
sudo "/Applications/CMake.app/Contents/bin/cmake-gui" --install，它会自动创建符号链接到/usr/local/bin—— 但需注意：系统完整性保护（SIP）可能阻止写入/usr/local/bin，尤其 macOS Sonoma 及更新版本
验证与常见陷阱
执行 cmake --version 成功，不代表万事大吉。真正容易出问题的是后续构建行为。
- 如果
cmake ..报错Could not find compiler set in environment variable CC，说明 CMake 找不到编译器 —— 不是 CMake 问题，是 Xcode Command Line Tools 没装：xcode-select --install - VS Code 中 CMake Tools 插件不识别
cmake，通常是因为它读取的是 VS Code 启动时的环境变量；关掉再重开 VS Code，或从终端用code .启动 - 用
brew install cmake装的版本可能比官网 DMG 新（Homebrew 通常同步较快），但如果你项目强制要求某个特定版本（比如 3.22.x），就得用 DMG + 手动 PATH，避免 brew 升级覆盖
最关键的其实是路径加载时机：改完 ~/.zshrc 必须 source 或新开终端，否则 shell 还是旧的 PATH。很多人卡在这一步，反复检查安装包却漏了 reload 环境变量。
