Maven本身不识别环境变量，本质是Windows通过PATH查找mvn.cmd并执行；需配置MAVEN_HOME指向根目录、PATH包含%MAVEN_HOME%\bin，并重启终端使变量生效，且JAVA_HOME必须已正确配置。
Maven 本身不会“主动识别”环境变量，而是你的操作系统（Windows）在你输入 mvn 命令时，按规则查找并执行对应程序。所谓“配置好后 Maven 怎么识别”，其实是：系统如何通过环境变量找到并运行 mvn.cmd。关键不在 Maven，而在 Windows 的命令解析机制。
Maven 命令能运行的本质：PATH 查找机制
当你在 CMD 或 PowerShell 中输入 mvn -v，系统会做这件事：
- 检查你当前输入的
mvn是不是内置命令（如dir、cd），不是 → 继续 - 按照
PATH环境变量中列出的所有目录顺序，逐个查找是否存在名为mvn.cmd（Windows）、mvn.bat或mvn（可执行文件）的文件 - 一旦在某个目录（比如
D:\apache-maven-3.9.6\bin）里找到mvn.cmd，就立即调用它，并把-v当作参数传入 -
mvn.cmd内部会读取MAVEN_HOME（或回溯父目录），加载lib/下的 JAR，再启动 JVM 运行 Maven 核心逻辑
所以，“Maven 识别环境变量”这个说法不准确；真正起作用的是：
✅ MAVEN_HOME 告诉 mvn.cmd 自己在哪安家（用于定位 lib/ 和 conf/）
✅ PATH 告诉 Windows：“mvn.cmd 就藏在这个 bin 目录里，别去别处找了”
验证是否真被系统“认出”的三步检查法
-
确认
MAVEN_HOME已生效
在新打开的 CMD 中运行：echo %MAVEN_HOME%
应输出类似
D:\apache-maven-3.9.6（必须是解压根目录，不能带\bin） -
确认
PATH包含%MAVEN_HOME%\bin
运行：echo %PATH%
找到其中是否有
D:\apache-maven-3.9.6\bin（或%MAVEN_HOME%\bin已被展开）。注意：- 路径之间用英文分号
;分隔 - 不要有多余空格或中文字符
- 大小写不敏感，但变量名
MAVEN_HOME必须拼写完全一致
- 路径之间用英文分号
-
直接测试
mvn.cmd是否可执行
进入 Maven 的bin目录，手动运行：cd /d D:\apache-maven-3.9.6\bin mvn.cmd -v
如果成功打印版本信息，说明 Maven 安装完好，问题只出在
PATH或终端未刷新。
为什么配完还要重启终端？
因为环境变量是在进程启动时加载进内存的。你修改了系统设置，但已打开的 CMD/PowerShell/IDE 内置终端仍用着旧的 PATH 副本。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 关闭所有终端窗口（包括 VS Code、IntelliJ 的 Terminal 标签页）
- 重新打开一个全新终端，再执行
mvn -v
? 小技巧：在 PowerShell 中可临时强制重载用户级 PATH（不推荐长期依赖）：
$env:Path = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Environment]::GetEnvironmentVariable("Path","User")
补充：Java 环境是前置硬性条件
mvn.cmd 启动时会调用 java.exe。如果 JAVA_HOME 未设置，或 PATH 里没有 java，即使 mvn 找到了，也会报错：
Error: JAVA_HOME not set
所以务必先验证：
java -version echo %JAVA_HOME%
二者都应正常返回，且 JAVA_HOME 指向 JDK 根目录（如 C:\Program Files\Java\jdk-17.0.2），不是 jre 或 bin 子目录。
不复杂但容易忽略
