必须正确配置MAVEN_HOME和Path环境变量，否则mvn命令报错，导致Java项目构建、依赖下载及IDEA集成全部失败；需先确认JDK就绪（java/javac -version均成功），再下载解压Maven至无空格纯英文路径，最后设置MAVEN_HOME指向根目录、Path添加%MAVEN_HOME%\bin。
要在Windows上让命令行和IDEA都能识别并调用Maven，必须正确配置MAVEN_HOME和Path两个环境变量，否则mvn命令会提示“不是内部或外部命令”，后续所有Java项目构建、依赖下载、IDEA集成都会失败。
确认JDK已就绪并获取安装路径
打开cmd，依次执行java -version和javac -version，两行都必须输出版本号且不报错；如果javac失败，说明只装了JRE或JAVA_HOME未配置——【这一步不通过，Maven绝对无法运行】。记下java -XshowSettings:properties 2>&1 | findstr "java.home"输出的路径，例如C:\Program Files\Java\jdk-17.0.2，这就是后续验证Maven兼容性的依据。
下载解压Maven到无空格纯英文路径
访问https://maven.apache.org/download.cgi，下载Binary zip archive（如apache-maven-3.9.8-bin.zip），不要选Source包。解压到类似D:\dev\maven的路径，确保路径中不含中文、空格、括号或特殊符号——【路径含空格会导致mvn命令解析失败，且错误提示极难定位】。解压后目录结构应为D:\dev\maven\apache-maven-3.9.8\bin\mvn.cmd。
配置系统级环境变量
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。在“系统变量”区域点击“新建”，变量名填MAVEN_HOME，变量值填你刚才解压的完整根路径（不含bin），例如D:\dev\maven\apache-maven-3.9.8。
在“系统变量”中找到Path，双击编辑→“新建”→输入%MAVEN_HOME%\bin。这一步把mvn.cmd所在目录加入全局可执行路径。
关闭所有已打开的cmd窗口，重新以管理员身份启动一个新cmd，执行mvn -v。若看到Maven、Java、OS三行版本信息，则环境变量配置成功；若提示“mvn 不是内部或外部命令”，请检查是否漏掉Path里的%MAVEN_HOME%\bin，或是否在旧cmd窗口中执行验证。
验证并强制刷新环境变量生效
方法一：在新cmd中执行echo %MAVEN_HOME%，确认输出与你设置的路径完全一致；再执行where mvn，应返回%MAVEN_HOME%\bin\mvn.cmd的绝对路径。
方法二：若echo显示为空或路径错误，说明变量未写入系统变量而是误写入用户变量，或拼写错误（比如写成M2_HOME或maven_home）；此时需回到环境变量界面，确认修改的是“系统变量”而非“用户变量”，且变量名严格为MAVEN_HOME（全大写、无空格）。
方法三：某些企业电脑启用了组策略限制，即使手动添加也无法生效，此时需联系IT部门开通权限——这种情况在金融、政务类单位内网环境中高频出现。
