MacOS安装mvn命令

以下是在 macOS 上安装 Maven（mvn 命令）的详细步骤，综合了多个来源的最新信息：

1. 下载 Maven

• 访问 https://maven.apache.org/download.cgi 下载最新稳定版（如 apache-maven-3.9.6-bin.tar.gz）。
• 推荐选择二进制压缩包（tar.gz），适用于 macOS 系统。

2. 解压并移动安装包

• 解压下载的文件（例如到 ~/Downloads 目录）：

  tar -xzvf apache-maven-3.9.6-bin.tar.gz
  

• 将解压后的文件夹移动到系统目录（如 /usr/local 或用户自定义目录）：

  sudo mv apache-maven-3.9.6 /usr/local/
  

  若需自定义路径（如 /Users/用户名/tools），需确保权限正确。

3. 配置环境变量

根据 macOS 的 Shell 类型（bash 或 zsh）选择配置文件：

• bash 用户（旧版 macOS）：

  vim ~/.bash_profile
  

• zsh 用户（Catalina 及之后版本默认）：

  vim ~/.zshrc
  

在文件中添加以下内容（替换路径为实际安装路径）：

export MAVEN_HOME=/usr/local/apache-maven-3.9.6  # 或自定义路径
export PATH=$MAVEN_HOME/bin:$PATH

注意：早期教程可能使用 M2_HOME，但推荐统一用 MAVEN_HOME。

4. 使配置生效

• 执行以下命令加载配置：

  source ~/.bash_profile  # 或 source ~/.zshrc
  

5. 验证安装

运行以下命令检查是否成功：

mvn -v

若输出包含 Maven 版本和 JDK 信息（如 Apache Maven 3.9.6），则安装成功。

常见问题及解决

1. mvn: command not found

   • 检查环境变量路径是否正确，尤其是 MAVEN_HOME 和 PATH 的拼接。
   • 确保执行了 source 命令或重启终端。

2. JDK 依赖
   Maven 需要 JDK 环境，需提前安装并配置 JAVA_HOME。可通过 java -version 验证。

3. 权限问题
   若安装到系统目录（如 /usr/local），需使用 sudo 命令。

4. 配置镜像加速
   可修改 conf/settings.xml，添加阿里云镜像（示例见下文）：

   <mirror>
     <id>alimaven</id>
     <name>aliyun maven</name>
     <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
     <mirrorOf>central</mirrorOf>
   </mirror>
   

其他安装方式（可选）

• Homebrew 安装：
  通过 brew install maven 安装（需提前安装 Homebrew），但可能需解决依赖问题。

• 自定义本地仓库：
  修改 settings.xml 中的 <localRepository> 标签，指定本地仓库路径。

以上步骤综合了多个来源的最新实践，适用于大多数 macOS 版本。若遇到问题，可参考具体引用链接获取更详细的上下文。