Mac Sonoma系统zsh终端中mvn命令找不到的问题求助

步骤1：验证Maven文件路径与权限 #

先确认你的Maven安装目录和文件权限是否正确：

• 打开终端，执行以下命令检查目标目录是否存在mvn文件：

  ls /Users/myUser/apache-maven-3.6.3/bin
  

  如果输出里没有mvn，说明你移动的文件夹可能有误——比如解压后的文件夹可能带-bin后缀，检查下载目录里的解压包，把正确的文件夹移到/Users/myUser下。
• 如果存在mvn文件，检查执行权限：

  ls -l /Users/myUser/apache-maven-3.6.3/bin/mvn
  

  看输出的权限列（比如-rwxr-xr-x），如果没有x（执行权限），执行以下命令添加权限：

  chmod +x /Users/myUser/apache-maven-3.6.3/bin/mvn
  

步骤2：确保配置文件被正确加载 #

zsh的.zprofile仅在登录shell中加载，如果你是直接打开终端（非远程登录），可能需要手动加载配置：

source ~/.zprofile

执行完后再测试mvn -version。

如果每次新开终端都要手动执行source，可以把Maven的配置移到.zshrc里——.zshrc会在每个交互式shell启动时自动加载，配置内容不变：

export M2_HOME="/Users/myUser/apache-maven-3.6.3"
PATH="${M2_HOME}/bin:${PATH}"
export PATH

步骤3：检查PATH的最终内容 #

执行以下命令查看当前PATH，确认Maven的路径是否在其中：

echo $PATH

如果看不到/Users/myUser/apache-maven-3.6.3/bin，说明配置没生效。此时可以调整.zprofile里的代码顺序，把brew的配置移到前面（避免brew覆盖PATH）：

eval "$(/opt/homebrew/bin/brew shellenv)"
export M2_HOME="/Users/myUser/apache-maven-3.6.3"
PATH="${M2_HOME}/bin:${PATH}"
export PATH

保存后重新执行source ~/.zprofile再测试。

步骤4：直接指定路径测试 #

如果上述步骤都无效，直接执行Maven的完整路径，确认是否能运行：

/Users/myUser/apache-maven-3.6.3/bin/mvn -version

如果能运行，说明是PATH配置的问题；如果不能，说明Maven本身安装有问题，重新下载官方压缩包解压试试。

内容的提问来源于stack exchange，提问作者Blnpwr