Java项目Maven配置成功的关键是JAVA_HOME、MAVEN_HOME和PATH三者严格对齐：JDK版本需匹配Maven要求（如3.9+需JDK17+），须用官方二进制包安装并正确设置环境变量，推荐配置阿里云镜像加速依赖下载。
Java项目用Maven管理依赖和构建，不是“装了就能用”，关键在 MJAVA_HOME、MAVEN_HOME 和 PATH 三者是否真正对齐——多数报错如 mvn: command not found 或 Unsupported Java version 都源于其中一环断开。
确认 JDK 已正确安装且版本满足 Maven 要求
Maven 3.9+ 要求 JDK 17+，Maven 3.8.x 支持 JDK 8–17。运行 java -version 查看实际版本，注意别被系统默认的 JRE 或旧版 JDK 干扰。
- 用
which java（macOS/Linux）或where java（Windows）确认调用路径 - 检查
JAVA_HOME是否指向 JDK 根目录（不是jre子目录），例如：/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home - 若用 SDKMAN! 或 jEnv 管理多版本，确保当前 shell 中
java和JAVA_HOME一致
下载并解压 Maven 二进制包（不推荐用包管理器安装）
Homebrew（brew install maven）或 apt 安装常导致 MAVEN_HOME 不明确、配置文件被覆盖，调试困难。直接下载官方二进制包最可控。
- 从 https://www.php.cn/link/5131f6caead4314643b671b624714d94 下载
apache-maven-3.9.7-bin.zip（以最新稳定版为准） - 解压到无空格、无中文路径，例如：
/opt/apache-maven-3.9.7（macOS/Linux）或C:\apache-maven-3.9.7（Windows） - 设环境变量
MAVEN_HOME指向该目录，不是bin子目录
配置 PATH 并验证三要素联动
PATH 必须同时包含 $JAVA_HOME/bin 和 $MAVEN_HOME/bin，顺序无关，但缺一不可。Windows 用户注意用分号 ; 分隔，Linux/macOS 用冒号 :。
立即学习“Java免费学习笔记（深入）”；
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
验证命令：
echo $JAVA_HOME echo $MAVEN_HOME echo $PATH | grep -E "(java|mvn)" mvn -v
成功输出应类似：
Apache Maven 3.9.7 (b9261e504f37b665533c9f82945556322146f92a) Maven home: /opt/apache-maven-3.9.7 Java version: 17.0.10, vendor: Homebrew, runtime: /opt/homebrew/Cellar/openjdk@17/17.0.10/libexec/openjdk.jdk/Contents/Home
若提示 Could not find or load main class org.codehaus.plexus.classworlds.launcher.Launcher，说明 MAVEN_HOME 错误或 bin/mvn 脚本里 MAVEN_HOME 被硬编码覆盖。
修改 settings.xml 适配本地仓库与镜像（非必须但极常用）
全局配置文件位于 $MAVEN_HOME/conf/settings.xml，用户级配置优先用 ~/.m2/settings.xml（不存在可复制一份）。重点改两处：
-
<localRepository>：建议显式指定路径，避免默认在用户主目录下生成巨量缓存干扰备份或磁盘监控，例如：/Users/you/.m2/repository -
<mirror>：国内开发务必加阿里云镜像，否则依赖下载慢甚至超时
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
改完不用重启终端，但已有 mvn 进程不会自动重载；下次执行 mvn clean compile 即生效。注意不要在 settings.xml 里写错 XML 标签闭合，Maven 会静默失败并回退到默认配置。
