一、下载 Maven
1. 官网下载
访问 Maven 官方下载页面：maven.apache.org/download.cg…
2. 选择版本
选择 Binary zip archive 格式的压缩包（如 apache-maven-3.6.x-bin.zip），这是已编译的二进制版本，开箱即用。
3. 解压文件
将下载的压缩包解压到你指定的目录，例如：
C:\Java\apache-maven-3.6.3
解压后的目录结构如下：
apache-maven-3.6.3/
├── bin/ # 可执行命令目录
├── boot/ # 启动加载器
├── conf/ # 配置文件目录
├── lib/ # 依赖库目录
├── LICENSE
├── NOTICE
└── README.txt
二、配置环境变量
1. 配置 MAVEN_HOME
打开 此电脑 → 属性 → 高级系统设置 → 环境变量：
- 点击 新建 系统变量
- 变量名：
MAVEN_HOME - 变量值：
C:\Java\apache-maven-3.6.3（你的实际解压路径）
2. 配置 Path
在系统变量中找到 Path，点击 编辑：
- 新建一行，添加：
%MAVEN_HOME%\bin
编辑
3. 验证安装
打开命令提示符（CMD），输入：
mvn -v
如果显示类似以下信息，说明配置成功：
编辑
三、配置本地仓库
Maven 默认从中央仓库下载的依赖包会存放在本地仓库中，建议自定义本地仓库位置，避免占用 C 盘空间。
1. 创建本地仓库目录
新建一个文件夹作为本地仓库，例如：
D:\mvn-repository
2. 修改 settings.xml
打开 Maven 安装目录下的 conf/settings.xml 文件，找到 <localRepository> 标签（默认被注释），添加或修改为：
<localRepository>D:\mvn-repository</localRepository>
四、配置阿里云镜像（加速下载）
Maven 默认从国外中央仓库下载依赖，速度较慢。配置阿里云镜像可以大幅提升下载速度。
在 settings.xml 文件中找到 <mirrors> 标签，添加以下内容：
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
注意：阿里云镜像地址已更新，建议使用
https://maven.aliyun.com/repository/public（原http://maven.aliyun.com/nexus/content/groups/public/仍可访问，但 HTTPS 更安全）
五、配置默认 JDK 版本
为避免每次创建项目都指定 JDK 版本，可在 settings.xml 中配置全局默认 JDK。
在 <profiles> 标签内添加：
<profile>
<id>JDK-17</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>17</jdk>
</activation>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
</properties>
</profile>
根据你的实际 JDK 版本修改，如使用 JDK 8 则将
17改为1.8
六、IDEA 中配置 Maven
1. 打开 IDEA 设置
File → Settings（或 Ctrl + Alt + S）
2. 搜索 Maven
在搜索框输入 "Maven"，找到 Build, Execution, Deployment → Build Tools → Maven
3. 配置路径
- Maven home path：选择你的 Maven 安装目录（如
C:\Java\apache-maven-3.6.3） - User settings file：选择
conf/settings.xml路径 - Local repository：会自动识别你在 settings.xml 中配置的本地仓库路径
4. 应用配置
点击 Apply → OK 保存设置
七、常用 Maven 命令
| 命令 | 说明 |
|---|---|
mvn -v | 查看 Maven 版本 |
mvn clean | 清理 target 目录 |
mvn compile | 编译源代码 |
mvn test | 运行测试 |
mvn package | 打包项目 |
mvn install | 打包并安装到本地仓库 |
mvn deploy | 部署到远程仓库 |
八、常见问题
Q1: 提示 "mvn 不是内部或外部命令"
解决：检查环境变量 Path 是否正确配置 %MAVEN_HOME%\bin，配置后需重启 CMD 窗口。
Q2: 下载依赖速度很慢
解决：确认阿里云镜像配置正确，且 URL 可访问。可尝试更换为其他镜像源，如腾讯云、华为云等。
Q3: 本地仓库占用空间过大
解决：定期清理不用的依赖，或删除本地仓库目录中的 _remote.repositories 和 *.lastUpdated 文件后重新下载。
Q4: 输入mvn -v出现下面问题
The JAVA_HOME environment variable is not defined correctly
This environment variable is needed to run this program
NB: JAVA_HOME should point to a JDK not a JRE
解决： 1、检查是否安装JDK ； 2、检查是否设置设置 JAVA_HOME 环境变量
