在 Windows 上设置 MAVEN_HOME 环境变量（完整指南）
在 Windows 系统上使用 Maven 时，正确配置 MAVEN_HOME 与 PATH 环境变量是必不可少的操作。尤其在开发 Java 项目、构建 Spring Boot 服务、集成 GitLab CI/CD、使用 IntelliJ IDEA 或 VS Code 进行编译构建时，环境变量配置是否规范将直接影响 Maven 的正常运行。
本文将详细讲解如何在 Windows 上安装 Maven，并正确设置 MAVEN_HOME 与相关的环境变量。
一、下载并安装 Maven
Maven 的下载地址（Apache 官方）：
https://maven.apache.org/download.cgi
选择最新稳定版，例如：
- apache-maven-3.9.x-bin.zip
下载后进行解压，无需安装程序（Maven 本身是绿色软件）。
建议解压到如下目录：
C:\Program Files\Maven\apache-maven-3.9.x或使用无空格目录：
C:\Dev\maven\apache-maven-3.9.x解压后的 Maven 目录结构如下：
apache-maven-3.9.x
│ LICENSE
│ NOTICE
│ README.txt
└─ bin
└─ conf
└─ lib二、设置 MAVEN_HOME 环境变量
Maven 依赖 JAVA_HOME，因此在配置 Maven 之前，请确保 Java 环境已配置完成（JAVA_HOME 已设置）。
1. 打开系统环境变量窗口
操作步骤：
- 在桌面上右键"此电脑"→"属性"
- 点击左侧"高级系统设置"
- 点击"环境变量(N)..."
2. 新建 MAVEN_HOME
在"系统变量"区域点击"新建"：
-
变量名 ：
MAVEN_HOME -
变量值：填写 Maven 的根目录，例如：
C:\Program Files\Maven\apache-maven-3.9.6
确认保存。
三、添加 Maven 到 Path 环境变量
为了在任何路径使用 mvn 命令，需要把 Maven 的 bin 目录添加到 PATH 中。
1. 编辑 Path
在"系统变量"中找到：
Path点击"编辑"。
2. 添加新条目
点击"新建"，输入：
%MAVEN_HOME%\bin保存。
四、验证 Maven 环境是否生效
打开一个新的 cmd 命令行窗口（必须是新的，会重新加载环境变量），执行：
mvn -v如果输出类似：
Apache Maven 3.9.6
Maven home: C:\Program Files\Maven\apache-maven-3.9.6
Java version: 17.0.17, vendor: Oracle Corporation
OS name: "windows 10", version: "10.0", arch: "amd64"说明 Maven 已经正确配置。
五、可选：配置 Maven 的本地仓库（本地库加速）
默认仓库路径：
C:\Users\<你的用户名>\.m2\repository如果你希望把 Maven 仓库放到其他位置（如 D 盘），可修改 Maven 的 settings.xml。
1. 打开配置文件
%MAVEN_HOME%\conf\settings.xml2. 找到 <localRepository> 字段并取消注释
修改为例如：
xml
<localRepository>D:\m2-repo</localRepository>保存后 Maven 下载依赖都会写到新的仓库。
六、可选：添加镜像源（加速下载）
通常建议添加国内镜像以提升依赖下载速度。在 settings.xml 里找到 <mirrors> 部分，加入以下镜像：
xml
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>保存后 Maven 的构建速度将明显提升。
七、常见问题与排查
1. 执行 mvn -v 时提示"mvn 不是内部或外部命令"
原因：PATH 未配置正确。
排查：
Path是否包含%MAVEN_HOME%\binMAVEN_HOME是否为 Maven 根目录，而非 bin 目录- cmd 是否重新打开
2. 提示 JAVA_HOME 未设置
说明 Java 环境变量配置不完整。
需确认：
echo %JAVA_HOME%是否有输出。
3. Path 中不要引用 Maven 根目录
错误写法：
C:\Program Files\Maven\apache-maven-3.9.6正确写法：
%MAVEN_HOME%\bin