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