必须配置MAVEN_HOME、Path、MAVEN_OPTS三组环境变量:MAVEN_HOME指向Maven解压路径(如D:\dev\maven),Path添加%MAVEN_HOME%\bin以识别mvn命令,MAVEN_OPTS设为-Xms256m -Xmx1024m优化内存;全部配置后需重启CMD并用echo %MAVEN_HOME%、mvn -v、mvn -X | findstr "MAVEN_OPTS"三步验证。

要让命令行能识别mvn命令、让IDEA正确加载Maven、让多模块项目顺利构建,必须完成Windows系统下MAVEN_HOME、Path、MAVEN_OPTS这三组环境变量的精准配置,缺一不可。
确认JDK已就绪并获取Maven安装包
打开CMD,执行java -version,看到类似java version "1.8.0_311"的输出才算过关;未通过则先装JDK并配好JAVA_HOME。访问https://maven.apache.org/download.cgi,下载apache-maven-3.9.16-bin.zip(截至2026年8月最新稳定版)。
解压到纯英文无空格路径,例如D:\dev\maven,【禁止放在C:\Program Files或桌面等含空格路径】,否则后续mvn命令会报错找不到类加载器。
配置MAVEN_HOME系统变量
右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”区域点击“新建”。
变量名填MAVEN_HOME,变量值填你刚才解压的完整路径,例如D:\dev\maven。
这一步是核心锚点:后续所有依赖都靠它定位,升级Maven时只需改这里,不用碰Path。
将mvn命令注入系统路径
在“系统变量”列表中找到Path,点击“编辑”→“新建”→输入%MAVEN_HOME%\bin。
注意:不要手敲完整路径,必须用%MAVEN_HOME%\bin这种引用写法,否则MAVEN_HOME变更后Path就失效了。
全部点击“确定”关闭窗口后,【必须关闭所有已打开的CMD窗口,重新打开一个才生效】。
优化Maven运行内存(防打包崩溃)
仍在“系统变量”区域点击“新建”:
变量名:MAVEN_OPTS
变量值:-Xms256m -Xmx1024m
这个配置专治大型项目执行mvn package时突然中断报OOM——初始堆设256MB,上限拉到1024MB,比默认值更稳妥。
验证三重配置是否全部成功
打开全新CMD窗口,依次执行以下三条命令:
1、echo %MAVEN_HOME% → 应显示你设定的解压路径
2、mvn -v → 显示Apache Maven 3.9.16及Java版本信息
3、mvn -X | findstr "MAVEN_OPTS" → 输出中应包含-Xms256m -Xmx1024m
三项全通过,说明MAVEN_HOME、Path、MAVEN_OPTS均已正确载入系统。

















