cmake在mac上未找到需配置path,推荐三种独立方法:一、homebrew一键安装自动配置路径;二、dmg拖拽安装后手动将/applications/cmake.app/contents/bin加入shell配置文件;三、源码编译安装至/usr/local(默认在path中)。

如果您在Mac上需要使用CMake构建C/C++项目,但终端中输入cmake --version提示命令未找到,则说明CMake的可执行文件尚未被系统PATH识别。以下是三种互不依赖、可独立生效的安装与配置方法:
一、通过Homebrew一键安装(推荐新手)
Homebrew会自动将cmake二进制文件安装至/opt/homebrew/bin(Apple Silicon)或/usr/local/bin(Intel),并确保其位于shell的PATH最前端,无需手动编辑环境变量文件。
1、确认已安装Homebrew:在终端中运行which brew,若返回路径则继续;否则请先执行官方安装脚本。
2、更新Homebrew索引:brew update
3、执行安装命令:brew install cmake
4、验证安装结果:cmake --version,输出应为类似cmake version 3.29.2的响应。
二、DMG拖拽安装后配置PATH(适用于离线或需GUI)
从官网下载的.dmg包本质是CMake.app应用包,其命令行工具实际位于/Applications/CMake.app/Contents/bin/目录下。该路径默认不在系统PATH中,因此需显式添加。
1、访问https://cmake.org/download/,下载macOS Universal DMG文件(支持M1/M2及Intel芯片)。
2、双击挂载镜像,将CMake图标拖入/Applications文件夹。
3、打开终端,判断当前shell类型:echo $SHELL;若显示/bin/zsh(macOS Catalina起默认),则编辑~/.zshrc;若为/bin/bash,则编辑~/.bash_profile。
4、执行echo 'export PATH="/Applications/CMake.app/Contents/bin:$PATH"' >> ~/.zshrc(zsh用户)或对应bash配置文件。
5、重新加载配置:source ~/.zshrc(或source ~/.bash_profile)。
6、运行cmake --version确认命令可用。
三、从源码编译安装(适用于定制化需求)
此方式绕过预编译包限制,可指定编译选项(如启用/禁用特定模块)、适配特殊系统路径或调试CMake自身行为。编译产物默认安装至/usr/local,该路径天然在系统PATH中。
1、确保已安装Xcode命令行工具:xcode-select --install,并验证clang --version有输出。
2、下载CMake源码压缩包(.tar.gz格式)并解压,进入解压后目录。
3、执行引导脚本:./bootstrap --prefix=/usr/local --parallel=$(sysctl -n hw.ncpu)。
4、编译:make -j$(sysctl -n hw.ncpu)。
5、安装:sudo make install。
6、立即生效:hash -r清空shell命令哈希缓存,再执行cmake --version验证。











