新电脑装完 JDK，解压 Maven 后打开 cmd 输入 mvn -v，回一句「mvn 不是内部或外部命令」。九成是环境变量没配，或者配完没开新窗口。

先确认 JDK 装好了

Maven 本身是 Java 程序，必须先有 JDK。命令行输入 java -version，能看到版本号再往下走。JAVA_HOME 要指向 JDK 的安装目录，不是里面的 jre 子目录，这一点最容易错。不少 maven环境变量配置教程 只写 Path，漏了 JAVA_HOME，配完照样起不来。

MAVEN_HOME 和 Path 两步

把 apache-maven-3.x 解压到不含空格和中文的目录，比如 D:/dev/maven。右键此电脑→属性→高级系统设置→环境变量，在系统变量里新建 MAVEN_HOME，值填 D:/dev/maven。

再找到 Path，点编辑→新建，加一行 %MAVEN_HOME%/bin。确定保存后，关掉所有 cmd 窗口重新打开，旧窗口读不到新变量。

输入 mvn -v，正常会先打印 Apache Maven 版本，再打印 Java version 和 Java home。只显示 Maven 版本、Java home 是乱码或空白，多半还是 JAVA_HOME 指错了地方。

settings.xml 顺手改两处

在 Maven 目录的 conf 下找到 settings.xml。第一处是 localRepository，指到空间大的盘，默认放在 C 盘用户目录，依赖多了很占地方。第二处是 mirrors，加国内镜像能明显加快下载，地址填镜像站提供的公共仓库地址。

常见报错对照

  • 提示 JAVA_HOME not found：变量名拼错，或者值带到了 bin 目录
  • mvn 能跑但编译报无效的发行版：JDK 版本和项目 pom 里的 compiler 配置不匹配
  • IDEA 里终端正常、系统 cmd 不行：IDE 有自己的环境变量设置，两边要分别配

maven环境变量配置教程看一遍就够，关键就三样：JDK 装好、MAVEN_HOME 指对、Path 加 bin。配完一定重开命令行再验证。