Maven本地安装与MAVEN_HOME配置核心为三步：解压至无中文无空格路径、新建系统变量MAVEN_HOME指向根目录、将%MAVEN_HOME%\bin加入Path，最后执行mvn -v验证版本、Maven home路径及Java version三者一致。
Java 中 Maven 的本地安装和 MAVEN_HOME 环境变量配置，核心是三步：解压、设变量、验证。只要 JDK 已就位（JAVA_HOME 正确），这一步几乎不会出错。
下载与解压 Maven
从官网 https://www.php.cn/link/5131f6caead4314643b671b624714d94 下载二进制 zip 包（如 apache-maven-3.9.5-bin.zip），解压到一个**无中文、无空格**的路径，例如：
-
Windows：
C:\maven或D:\Tools\maven -
macOS/Linux：
/usr/local/maven或~/tools/maven
解压后确认目录下有 bin、conf、lib 等子文件夹，说明结构完整。
配置 MAVEN_HOME 系统变量
MAVEN_HOME 指向的是 Maven 的**根安装目录**（不是 bin 目录），必须准确设置：
立即学习“Java免费学习笔记（深入）”；
-
Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→在「系统变量」区点击「新建」：
变量名：MAVEN_HOME
变量值：C:\maven（替换成你自己的实际路径） -
macOS/Linux：编辑
~/.zshrc（或~/.bashrc）：export MAVEN_HOME=/usr/local/mavenexport PATH=$MAVEN_HOME/bin:$PATH
保存后执行source ~/.zshrc
把 bin 加入 Path 并验证
仅设 MAVEN_HOME 不够，必须让系统找到 mvn 命令：
- 在 Windows 的「系统变量」中找到
Path，点击「编辑」→「新建」→输入：%MAVEN_HOME%\bin - 重启命令行终端（旧窗口不读新变量），运行：
mvn -v
成功输出应包含三行关键信息：
-
Apache Maven X.X.X（版本号） -
Maven home: C:\maven（路径必须与 MAVEN_HOME 一致） -
Java version: X.X.X（说明 JAVA_HOME 已生效）
常见失败原因与快速排查
如果 mvn -v 报错，优先检查这几项：
-
'mvn' 不是内部或外部命令→ Path 没加对，或没重启终端，或写成了%MAVEN_HOME%bin（漏了反斜杠） -
The JAVA_HOME environment variable is not defined correctly→ 先确保JAVA_HOME已设且指向 JDK 根目录（如C:\Program Files\Java\jdk-17），不是 jre，也不是 bin 目录 - 显示版本但
Maven home路径异常（比如指向.m2）→ MAVEN_HOME 值填错了，可能误填为bin目录或用户目录
