1 安装前置条件
本地必须提前安装 JDK1.8 及以上版本 ,并配置好JAVA_HOME系统环境变量,Maven 运行依赖 JVM。
2 Maven 压缩包目录解析
- 下载Maven
*- 地址:Download Apache Maven -- Maven
- 下载地址:Index of /dist/maven/maven-3/3.6.0/binaries
- 版本:Maven3.6
从官网下载 Maven 压缩包,解压路径不能包含中文、空格,解压后目录分工:

- bin:存放
mvn(Linux) /mvn.cmd(Windows) 执行脚本,提供命令行指令 - boot:Maven 内置类加载器核心框架
- conf:存放全局配置文件
settings.xml(核心配置文件) - lib:Maven 自身运行所需的全部依赖 jar 包
- LICENSE、README:版本说明文档,无需修改
3 Windows 环境变量配置
3.1 配置 MAVEN_HOME
新建系统变量,变量名:MAVEN_HOME 变量值:Maven 解压后的根目录,例 D:\tools\apache-maven-3.6.0

3.2 配置 Path 系统变量
在 Path 列表末尾新增一条:
plaintext
%MAVEN_HOME%\bin
配置完成后,任意 CMD、PowerShell 窗口都能识别mvn命令。

3.3 MAVEN_OPTS 内存参数配置
作用:控制 Maven 运行时 JVM 堆内存,多模块打包防止 OOM 内存溢出 新建系统变量 MAVEN_OPTS,值:
plaintext
-Xms128m -Xmx512m
-Xms128m:JVM 初始堆内存 128M-Xmx512m:JVM 最大可用堆内存 512M
4 两份 settings.xml 配置文件区分
Maven 存在两份仓库配置文件,用户配置优先级 > 全局配置,重复配置会覆盖全局:
表格
| 文件路径 | 生效范围 | 优先级 |
|---|---|---|
| Maven 解压目录 /conf/settings.xml | 本机所有操作系统用户(全局) | 低 |
| C:\Users\ 你的用户名.m2\settings.xml | 仅当前登录系统用户 | 高 |
补充说明
.m2文件夹第一次执行mvn命令自动生成;- 日常开发推荐修改用户目录下的 settings,不会影响其他用户。
5 验证 Maven 安装是否成功
关闭所有旧终端窗口,重新打开 CMD/PowerShell,执行命令:
bash
运行
mvn -v
输出 Maven 版本、JDK 版本、本地仓库路径即代表配置成功。

6 常见报错解决方案
报错 1:提示 ' mvn ' 不是内部或外部命令
原因:Path 环境未配置 / 配置后未重启终端 解决:重新检查 Path,关闭终端重新打开测试。
报错 2:提示Program Files路径引号报错
原因:JDK 路径带有空格,PowerShell 解析出错 解决 1:将 JDK 转移到无空格路径,如D:\jdk21 解决 2:修改 JAVA_HOME 使用 8.3 短路径 C:\Progra~1\Java\jdk-21.0.11
本章小结
- Maven 安装依赖 JDK,解压路径禁止中文空格;
- 环境变量核心:
MAVEN_HOME、Path、MAVEN_OPTS; - 两份 settings 文件作用不同,用户配置优先级更高;
mvn -version是验证安装的标准命令。