Maven 环境配置教程（2025 最新版）

最新版本：Apache Maven 3.9.11

前置要求：已安装 JDK 8 或更高版本（推荐 JDK 17/21）。

下载地址：
apache-maven-3.9.11-bin.zip（15MB）

---

一、下载与解压

1. 下载：点击上方链接下载 apache-maven-3.9.11-bin.zip
2. 解压：解压到任意目录（无中文、无空格）

   Windows: D:\tools\apache-maven-3.9.11
   macOS/Linux: /usr/local/apache-maven-3.9.11

---

二、配置环境变量

Windows

1. 新建系统变量： 变量名 变量值 M2_HOME D:\tools\apache-maven-3.9.11 MAVEN_HOME D:\tools\apache-maven-3.9.11（可选）
2. 编辑 Path：添加 %M2_HOME%\bin
3. 重启命令提示符，输入：

   mvn -version

（右键“此电脑” → 属性 → 高级系统设置 → 环境变量）

macOS / Linux

1. 编辑 ~/.bash_profile 或 ~/.zshrc：

   export M2_HOME=/usr/local/apache-maven-3.9.11
   export PATH=$M2_HOME/bin:$PATH

2. 生效：

   source ~/.zshrc  # 或 source ~/.bash_profile
   mvn -version

预期输出：

Apache Maven 3.9.11
Java version: 17.0.12, vendor: Oracle Corporation
Maven home: /path/to/apache-maven-3.9.11

---

三、配置阿里云镜像（加速下载 10倍速！）

本地仓库：默认 ~/.m2/repository/（约 1-10GB）

1. 创建/编辑 settings.xml：

   Windows: %M2_HOME%\conf\settings.xml
   macOS/Linux: $M2_HOME/conf/settings.xml

2. 完整配置（替换 <mirrors> 标签）：

   <?xml version="1.0" encoding="UTF-8"?>
   <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
             https://maven.apache.org/xsd/settings-1.0.0.xsd">

       <!-- 本地仓库路径（可选，自定义） -->
       <localRepository>D:\tools\.m2\repository</localRepository>

       <mirrors>
         <!-- 阿里云镜像 -->
         <mirror>
           <id>aliyunmaven</id>
           <mirrorOf>central</mirrorOf>
           <name>阿里云公共仓库</name>
           <url>https://maven.aliyun.com/repository/public</url>
         </mirror>
         <!-- 阿里云中央仓库 -->
         <mirror>
           <id>ali-central</id>
           <mirrorOf>central</mirrorOf>
           <name>aliyun nexus</name>
           <url>https://maven.aliyun.com/repository/central</url>
         </mirror>
       </mirrors>

   </settings>

---

四、IDE 集成配置

IntelliJ IDEA（推荐）

1. 打开设置：File → Settings → Build → Build Tools → Maven
2. 配置路径： 设置项 值 Maven home path /path/to/apache-maven-3.9.11 User settings file /path/to/conf/settings.xml Local repository D:\tools\.m2\repository
3. 勾选：Override → Import Maven projects automatically
4. 重启 IDEA，右上角 Maven 面板出现 ✅

Eclipse

1. Help → Install New Software → 添加 Maven 插件（或下载 Eclipse for Java EE）
2. Window → Preferences → Maven → Installations → 添加 Maven 路径
3. User Settings → 选择 settings.xml

---

五、验证安装（必做！）

mvn -version          # 显示版本信息
mvn help:system       # 显示系统信息
mvn archetype:generate -DgroupId=com.test -DartifactId=test -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

成功：自动创建 test/ 项目文件夹！

---

六、常见问题解决

问题	解决方案
mvn: command not found	检查 PATH 是否包含 $M2_HOME/bin
JAVA_HOME not set	设置 JAVA_HOME=/path/to/jdk
下载慢	配置阿里云镜像
权限问题（Linux）	chmod +x /path/to/bin/mvn
仓库路径权限	改 localRepository 为用户目录

---

七、一键安装（高级用户）

系统	命令
macOS	brew install maven
Ubuntu	sudo apt install maven
Windows	choco install maven

---

配置完成！ 现在运行 mvn archetype:generate 创建第一个项目吧！

问题反馈：命令报错？截图发我！需要 VS Code / Spring Boot 配置？继续问～ 🚀