在 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.xml

2. 找到 `<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%\bin
MAVEN_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

在 Windows 上设置 MAVEN_HOME 环境变量（完整指南）