macOS 13.2.1下npm安装Maven后mvn命令未找到及权限问题求助

问题根源 #

npm仓库中的maven包是第三方Node.js封装工具，并非官方Apache Maven，它不会自动将mvn命令添加到系统PATH环境变量中，因此即使安装成功也无法直接调用。全局安装时的EACCES权限错误，是因为普通用户无/usr/local/lib/node_modules目录的写入权限，sudo安装虽能绕过权限，但本质未解决命令可执行的核心问题。

正确安装Apache Maven的方法（macOS 13.2.1） #

方法1：通过Homebrew安装（推荐） #

Homebrew会自动配置环境变量，步骤简单：

1. 若未安装Homebrew，执行官方安装脚本：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装Maven：

   brew install maven
   

3. 验证安装：

   mvn -v
   

   输出Maven版本信息即为成功。

方法2：手动下载配置（自定义路径适用） #

1. 下载Apache Maven官方压缩包（如apache-maven-3.9.6-bin.tar.gz）
2. 解压到指定目录（示例为/usr/local/maven）：

   sudo tar -zxvf apache-maven-3.9.6-bin.tar.gz -C /usr/local/
   sudo mv /usr/local/apache-maven-3.9.6 /usr/local/maven
   

3. 配置环境变量：
   • 打开终端配置文件（zsh用户用~/.zshrc，bash用户用~/.bash_profile）：

     open ~/.zshrc
     

   • 添加以下内容：

     export MAVEN_HOME=/usr/local/maven
     export PATH=$MAVEN_HOME/bin:$PATH
     

   • 使配置生效：

     source ~/.zshrc
     

4. 验证安装：

   mvn -v
   

清理npm安装残留与修复权限（可选） #

若需移除之前通过npm安装的无效maven包：

sudo npm uninstall maven -g

修复npm全局目录权限，避免后续EACCES错误：

sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin
sudo chown -R $(whoami) /usr/local/share

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