CMake未安装或PATH未配置导致command not found,推荐用Homebrew一键安装并自动配置PATH;也可用DMG手动配置PATH,或从源码编译安装至/usr/local/bin。

在Mac终端输入cmake --version提示“command not found”,说明CMake命令行工具未被系统识别,必须完成安装并确保其二进制路径被写入shell的PATH环境变量,否则所有依赖CMake的构建流程(如编译C++项目、运行CMake Tools插件、执行ROS2 colcon build)都会失败。
用Homebrew一键安装并自动配置PATH(推荐新手)
这一步操作起来很简单,直接把Homebrew装好,cmake就自然可用,无需手动改配置文件。
1、先确认Homebrew是否已安装:在终端运行which brew,若返回/opt/homebrew/bin/brew(M1/M2)或/usr/local/bin/brew(Intel),则继续;否则请先执行官方安装脚本:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、更新包索引:brew update
3、安装CMake:brew install cmake。Homebrew会自动将可执行文件放至/opt/homebrew/bin(Apple Silicon)或/usr/local/bin(Intel),这两个路径默认已在系统PATH中且优先级足够高。
4、验证:cmake --version应输出类似cmake version 3.29.2的结果。若失败,请重启终端再试一次。
用DMG安装后手动配置PATH(适合需要GUI或离线环境)
从官网下载的.dmg安装包本质是CMake.app,其命令行工具藏在内部路径里,不手动加进PATH,终端永远找不到cmake命令。
方法一:临时生效(仅当前终端窗口有效)
在终端中直接执行:PATH="/Applications/CMake.app/Contents/bin:$PATH" → 然后立即运行cmake --version测试。注意:该命令本身不改变环境变量,只是设置一次当前shell的PATH,关闭窗口即失效。
CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
方法二:永久生效(需编辑shell配置文件)
① 访问cmake.org/download,下载macOS Universal DMG文件;
② 双击挂载,将CMake图标拖入/Applications文件夹;
③ 判断当前shell类型:echo $SHELL,macOS Catalina及以后默认为/bin/zsh,对应配置文件是~/.zshrc;
④ 执行:echo 'export PATH="/Applications/CMake.app/Contents/bin:$PATH"' >> ~/.zshrc;
⑤ 重新加载配置:source ~/.zshrc;
【注意】如果之前已向~/.zshrc写入过重复的PATH行,会导致命令冲突或报错,建议先用cat ~/.zshrc | grep CMake检查;
⑥ 运行cmake --version确认成功。
从源码编译安装并天然纳入PATH(适合定制化需求)
此方式生成的cmake默认安装到/usr/local/bin,而该路径早已在macOS系统PATH中,无需额外配置,但编译过程耗时较长且依赖Xcode命令行工具。
1、确保Xcode命令行工具已安装:xcode-select --install → 弹窗确认安装 → 安装完成后验证:clang --version有输出即可。
2、前往cmake.org/download下载.tar.gz源码包,解压后进入目录。
3、执行引导:./bootstrap --prefix=/usr/local --parallel=$(sysctl -n hw.ncpu)。这一步会检测系统环境并生成Makefile,【若提示缺少ncurses或libcurl,需先运行brew install ncurses curl】。
4、编译:make -j$(sysctl -n hw.ncpu)。
5、安装:sudo make install。执行后/usr/local/bin/cmake即存在,且因/usr/local/bin在系统PATH中,命令立即全局可用。










