Maven‑3.9.16 Windows 下载+安装+环境变量完整教程

还是大剑师兰特2026-09-03 15:35

一、下载

下载文件：apache‑maven‑3.9.16‑bin.zip（Binary zip archive）

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

不要下src源码包

二、解压安装

把zip解压到无中文、无空格路径，推荐路径：

D:\apache-maven-3.9.16

❌ 不要放：D:\Program Files\（带空格容易出错）、桌面、中文文件夹

解压后能看到里面有 bin、conf 等文件夹就正确。

三、配置环境变量

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

1.新建系统变量

变量名：MAVEN_HOME

变量值：D:\apache-maven-3.9.16 （你maven解压的根目录，不要带bin）

2.编辑 Path 系统变量

点击Path → 编辑 → 新建，填入：

复制代码

%MAVEN_HOME%\bin

3.检查JDK（Maven依赖Java）

Maven3.9 需要 JDK 8及以上

同样要有 JAVA_HOME 环境变量

四、验证是否安装成功

新开cmd窗口（**必须新开！**环境变量才生效）
输入命令：

mvn -v

出现版本信息，就配置成功。

五、可选：修改本地仓库 + 阿里云镜像（非常重要，解决下载慢）

打开maven目录下 conf/settings.xml

① 设置本地仓库路径

找到 <localRepository>，复制到外面修改（不要注释里面那行）

复制代码

<localRepository>D:\maven-repository</localRepository>

② 添加阿里云镜像

在<mirrors>标签里面粘贴

复制代码

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>阿里云中央仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

常见失败排查

'mvn' 不是内部或外部命令

环境变量Path没配置成功，或者cmd窗口没重启
MAVEN_HOME路径写错，末尾不能带\bin

报错Java版本不对：检查 JAVA_HOME，mvn -v 会显示使用的JDK