Maven 安装与配置指南（适用于 Windows、Linux 和 macOS）

Apache Maven 是一款广泛应用于 Java 项目的项目管理和构建工具。 本文提供在 Windows、Linux 和 macOS

系统上安装与配置 Maven 的详细步骤，旨在帮助开发者快速搭建高效的构建环境。

---

一、前置条件：安装 Java Development Kit (JDK)

Maven 依赖于 Java 运行环境，安装前需确保系统已安装 JDK（建议版本为 JDK 8 或更高）。

检查 JDK 安装情况

在终端或命令提示符中执行以下命令：

java -version

若系统返回 Java 版本信息，表示已正确安装 JDK。 若未安装，请先安装适合系统的 JDK 并配置相应的环境变量。

---

二、下载 Maven

访问 Apache Maven 官方下载页面：

https://maven.apache.org/download.cgi

选择最新稳定版本的二进制压缩包：(阿里云)

• Windows ：下载 .zip 文件
• Linux/macOS ：下载 .tar.gz 文件(腾讯云)

建议下载最新稳定版本（例如：3.9.9）。

---

三、安装与配置 Maven

1. 解压安装包

将下载的压缩包解压至指定目录，路径中避免包含空格或非 ASCII 字符。

示例路径：

• Windows ：C:\Program Files\apache-maven-3.9.9
• Linux/macOS ：/usr/local/apache-maven-3.9.9

2. 配置环境变量

Windows 系统

1. 设置系统环境变量 MAVEN_HOME，值为 Maven 的安装路径，例如：

   C:\Program Files\apache-maven-3.9.9

2. 编辑系统环境变量 Path，添加：

   %MAVEN_HOME%\bin

Linux/macOS 系统

1. 打开终端，编辑用户主目录下的 shell 配置文件：

   • Bash：~/.bashrc
   • Zsh：~/.zshrc

2. 在文件末尾添加以下内容：(阿里云)

   export MAVEN_HOME=/usr/local/apache-maven-3.9.9
   export PATH=$MAVEN_HOME/bin:$PATH

3. 保存文件并使配置生效：

   source ~/.bashrc  # 或 source ~/.zshrc

---

四、验证 Maven 安装

在终端或命令提示符中执行以下命令：

mvn -version

若系统返回 Maven 的版本信息，表示安装成功。

---

五、配置国内镜像源（可选）

为提高依赖包下载速度，可配置国内镜像源。

1. 打开 Maven 安装目录下的 conf/settings.xml 文件。

2. 在 <mirrors> 标签中添加以下内容：

   <mirror>
     <id>aliyunmaven</id>
     <mirrorOf>*</mirrorOf>
     <name>阿里云公共仓库</name>
     <url>https://maven.aliyun.com/repository/public</url>
   </mirror>

配置完成后，Maven 将优先从阿里云镜像下载依赖，提高下载速度。

---

六、配置本地仓库路径（可选）

默认情况下，Maven 将下载的依赖包存储在用户主目录下的 .m2/repository 目录中。 若需更改本地仓库位置，可在 settings.xml 文件中修改 <localRepository> 标签：

<localRepository>/path/to/your/repository</localRepository>

将 /path/to/your/repository 替换为期望的本地仓库路径。

---

七、在 IntelliJ IDEA 中配置 Maven（可选）

1. 打开 IntelliJ IDEA，进入：

   File > Settings > Build, Execution, Deployment > Build Tools > Maven

2. 在 Maven home directory 中，选择 Maven 的安装路径。

3. 在 User settings file 中，选择配置了镜像源的 settings.xml 文件。

4. 点击 Apply 和 OK 保存配置。

配置完成后，IntelliJ IDEA 将使用指定的 Maven 设置进行项目构建和依赖管理。

---

通过以上步骤，Maven 已在系统中成功安装并配置完毕。 可开始使用 Maven 管理和构建 Java 项目。

更多 Maven 使用方法和最佳实践，参考官方文档：

https://maven.apache.org/guides/index.html

---