Maven 下载与配置教程（新手友好版）

本文档手把手教你在 Windows 系统上安装和配置 Maven，全程从官方渠道下载，安全可靠。

---

一、Maven 是什么？

Maven 是 Java 项目的构建工具和依赖管理工具，简单说就是：

• 自动下载项目需要的第三方 jar 包（不用自己到处找）

• 一键编译、打包、运行项目

• 统一管理项目结构和构建流程

做 Java 开发基本都会用到它。

---

二、下载 Maven（官方渠道）

1. 打开官方下载页

浏览器访问 Maven 官网下载页：

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

2. 选择下载文件

在页面中找到 Files 区域，下载 Binary zip archive 版本：

文件名	说明
apache-maven-3.9.6-bin.zip	Windows 用这个（二进制压缩包）
apache-maven-3.9.6-bin.tar.gz	Linux/Mac 用这个
apache-maven-3.9.6-src.zip	源代码包（新手不需要）

版本号会更新，选最新的稳定版即可，比如 3.9.6、3.9.9 等。

3. 确认下载链接是官方的

下载链接域名必须是 dlcdn.apache.org 或 archive.apache.org，这是 Apache 官方的 CDN，放心下载。

---

三、安装 Maven（解压即可）

Maven 是绿色软件，不需要安装程序，解压就能用。

1. 选择解压目录

建议解压到一个没有空格、没有中文的目录，比如：

D:\ProgramData\apache-maven-3.9.6

不建议放在 C:\Program Files，因为路径有空格，可能导致一些插件出问题。

2. 解压

右键下载的 zip 包 → 「全部解压」→ 选择上面的目录 → 确定。

解压完成后，目录结构应该是这样的：

D:\ProgramData\apache-maven-3.9.6\
├── bin\          ← 可执行文件目录（mvn.cmd 在这里）
├── boot\
├── conf\         ← 配置文件目录（settings.xml 在这里）
├── lib\
├── LICENSE
├── NOTICE
└── README.txt

---

四、配置环境变量

这一步是为了让你在任意目录 下都能直接使用 mvn 命令。

1. 打开环境变量设置

按 Win + S 搜索「环境变量」→ 点击「编辑系统环境变量」→ 在弹出的窗口点「环境变量」按钮。

2. 新建 MAVEN_HOME 变量

在「用户变量」区域（上面那个框）：

1. 点「新建」

2. 变量名填：MAVEN_HOME

3. 变量值填：D:\ProgramData\apache-maven-3.9.6（就是你解压的目录）

4. 点确定

3. 把 Maven 加到 Path 变量

在「用户变量」里找到 Path：

1. 双击 Path

2. 点「新建」

3. 填：%MAVEN_HOME%\bin

4. 一路点确定保存所有窗口

4. 重启终端

已经打开的 CMD 或 PowerShell 要关掉重开，环境变量才会生效。

---

五、验证安装是否成功

打开一个新的 PowerShell 或 CMD，执行：

mvn --version

如果看到类似下面的输出，就说明安装成功了：

Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc295161ae)
Maven home: D:\ProgramData\apache-maven-3.9.6
Java version: 1.8.0_391, vendor: Oracle Corporation

注意：Maven 依赖 Java，所以电脑上必须先装 JDK。如果提示找不到 java，先去装 JDK。

---

六、进阶配置（推荐，国内用户必做）

1. 配置阿里云镜像（解决下载慢的问题）

Maven 默认从国外中央仓库下载依赖，国内速度很慢。配置阿里云镜像后，下载速度会快很多。

打开 Maven 配置文件：

D:\ProgramData\apache-maven-3.9.6\conf\settings.xml

找到 <mirrors> 标签，在里面加入：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

改完后保存，效果如下：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>*</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

2. 修改本地仓库位置（可选）

Maven 下载的 jar 包默认存在 C:\Users\你的用户名\.m2\repository，如果 C 盘空间紧张，可以改到其他盘。

在 settings.xml 中找到被注释的 localRepository，改成：

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

然后手动创建 D:\maven-repo 文件夹。

---

七、常用命令速查

命令	作用
mvn --version	查看 Maven 版本
mvn clean	清理 target 目录
mvn compile	编译项目
mvn test	运行单元测试
mvn package	打包项目（生成 jar/war）
mvn install	打包并安装到本地仓库
mvn spring-boot:run	运行 Spring Boot 项目
mvn clean package	清理后重新打包
mvn dependency:tree	查看依赖树

---

八、常见问题

Q1：输入 mvn 提示「不是内部或外部命令」

原因：环境变量没配对，或者配完没重启终端。

解决：

1. 检查 MAVEN_HOME 变量值是否正确（指向解压目录，不是 bin 目录）

2. 检查 Path 里是否加了 %MAVEN_HOME%\bin

3. 关掉所有终端窗口，重新打开一个再试

Q2：提示 JAVA_HOME 相关错误

原因：Maven 需要 Java 环境，电脑没装 JDK 或 JAVA_HOME 没配。

解决 ：先安装 JDK，然后配置 JAVA_HOME 环境变量指向 JDK 安装目录。

Q3：下载依赖特别慢

原因：用的是国外中央仓库。

解决：按本文第六步配置阿里云镜像。

Q4：下载依赖报错「Could not resolve dependencies」

原因：网络问题或镜像配置错误。

解决：

1. 检查网络是否正常

2. 检查 settings.xml 里的镜像 URL 是否正确

3. 尝试执行 mvn clean install -U（强制更新依赖）

Q5：升级 Maven 版本怎么做？

1. 下载新版本，解压到新目录（比如 D:\ProgramData\apache-maven-3.9.9）

2. 修改 MAVEN_HOME 环境变量指向新目录

3. 重启终端，执行 mvn --version 确认

---

九、卸载 Maven

Maven 是绿色软件，卸载很简单：

1. 删除解压目录（比如 D:\ProgramData\apache-maven-3.9.6）

2. 删除环境变量里的 MAVEN_HOME 变量

3. 从 Path 里删除 %MAVEN_HOME%\bin

4. （可选）删除本地仓库目录 C:\Users\你的用户名\.m2

---

十、官方资源

• 官网：Welcome to Apache Maven -- Maven

• 下载页：Download Apache Maven -- Maven

• 文档：Maven Documentation -- Maven

• 中央仓库：https://mvnrepository.com/（搜索依赖用）

---

本教程基于 Maven 3.9.6 + Windows 11 编写，其他版本和系统操作类似。