mac配置maven全局环境变量需先确认shell类型(zsh或bash),再将maven的bin目录正确添加至path并写入对应配置文件(~/.zshrc或~/.bash_profile),最后执行source命令使配置生效,验证mvn -v成功即完成。
mac上配置maven全局环境变量,关键在于确认当前shell类型、把maven的bin目录正确加入path,并让配置持久生效。只要路径对、文件对、执行顺序对,终端就能识别mvn命令。
先确认你用的是哪个Shell
macOS Catalina(10.15)起默认用zsh,Ventura/Sonoma/Monterey也延续此设置。运行以下命令查看:
echo $SHELL
输出/bin/zsh → 编辑 ~/.zshrc
输出/bin/bash → 编辑 ~/.bash_profile
安装Maven并确定实际路径
推荐两种方式,任选其一:
-
Homebrew一键安装(最简):终端运行
brew install maven,完成后用brew --prefix maven查看安装路径(如/opt/homebrew/Cellar/maven/3.9.6) -
手动下载解压(可控版本):从清华镜像站下载
apache-maven-x.x.x-bin.tar.gz,解压到稳定位置,例如:/usr/local/maven或~/tools/maven
写入环境变量配置文件
打开对应配置文件(以zsh为例):
nano ~/.zshrc
在文件末尾添加两行(请替换为你的实际路径):
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
export MAVEN_HOME=/usr/local/maven
export PATH=$MAVEN_HOME/bin:$PATH
⚠️ 注意:
– 不要用M2_HOME或MAVEN_HOME混用,IntelliJ等工具更认MAVEN_HOME;
– $MAVEN_HOME/bin必须放在$PATH前面,确保优先调用;
– 路径中避免空格和中文,否则可能报permission denied或找不到命令。
使配置立即生效并验证
保存退出后,在终端运行:
source ~/.zshrc
然后验证:
-
echo $MAVEN_HOME→ 应输出你设置的路径 -
echo $PATH→ 检查输出中是否包含bin目录 -
which mvn→ 应返回$MAVEN_HOME/bin/mvn -
mvn -v→ 显示Maven版本、Java版本及Maven home路径,即成功
如果遇到zsh: permission denied: mvn,说明bin下文件无执行权限,运行:
chmod +x $MAVEN_HOME/bin/mvn










