---
url: https://chenlj.top/md/develop/windows/maven-install.md
---
# windows 下 maven 安装

> Maven 依赖 JDK，请先完成 [windows 下 JDK 安装](./jdk-install)，确保 `JAVA_HOME` 已配置正确。

## 1、下载

[Maven 官方下载](https://maven.apache.org/download.cgi)

推荐从清华开源镜像站下载：<https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/>

选择 Binary zip 压缩包，本文以 3.9.16 为例：

```
apache-maven-3.9.16-bin.zip
```

## 2、解压

将压缩包解压到**不含中文、不含空格**的目录，例如：

```
D:\java\apache-maven-3.9.16
```

解压后目录结构应包含 `bin`、`conf`、`lib` 等文件夹。

## 3、配置环境变量

此电脑 → 属性 → 高级系统设置 → 环境变量 → 系统变量

（1）新建系统变量 `MAVEN_HOME`

| 变量名 | 变量值 |
| --- | --- |
| MAVEN\_HOME | D:\java\apache-maven-3.9.16 |

（2）编辑系统变量 `Path`，新增一项

```
%MAVEN_HOME%\bin
```

也可以使用命令行配置（需要以管理员身份运行 cmd）：

```bat
setx MAVEN_HOME "D:\java\apache-maven-3.9.16" /M
```

> `Path` 建议在图形界面里追加 `%MAVEN_HOME%\bin`，避免覆盖已有内容。

## 4、修改配置

编辑配置文件：

```
D:\java\apache-maven-3.9.16\conf\settings.xml
```

（1）自定义本地仓库位置（可选），默认是 `${user.home}/.m2/repository`

```xml
<localRepository>D:\java\maven-repo</localRepository>
```

（2）在 `<mirrors>` 节点下新增阿里云镜像，加速依赖下载

```xml
<mirror>
  <id>alimaven</id>
  <name>aliyun maven</name>
  <url>https://maven.aliyun.com/repository/public</url>
  <mirrorOf>central</mirrorOf>
</mirror>
```

（3）如需发布到私服，在 `<servers>` 节点下按需添加账号密码信息

## 5、验证

配置完成后需要**重新打开** cmd 窗口才能生效，执行：

```shell
mvn -v
```

能正常输出 Maven 版本、Java 版本及 Home 路径即表示安装成功：

```
Apache Maven 3.9.16
Maven home: D:\java\apache-maven-3.9.16
Java version: 21.0.2, vendor: Oracle Corporation
Java home: D:\java\jdk-21.0.2
```