Java项目用Maven需三步：1.配置JDK 11+的JAVA_HOME和PATH；2.下载解压Maven二进制包，设M2_HOME并加入PATH；3.修改settings.xml配置本地仓库路径和阿里云镜像源，确保终端mvn -v输出正确后，再同步IDE配置。
Java项目用Maven，不是装完就能直接用的；关键得让mvn命令能被识别、能联网下载依赖、且和JDK版本对得上——这三步缺一不可。
确认JDK已安装并配置好JAVA_HOME
Maven 3.9+ 要求 JDK 11 或更高版本，低于 JDK 8 的环境会直接报错 UnsupportedClassVersionError。光装了 JDK 不够，必须设置系统级环境变量：
-
JAVA_HOME指向 JDK 根目录（不是 JRE），例如C:\Program Files\Java\jdk-17（Windows）或/usr/lib/jvm/java-17-openjdk（Linux/macOS） -
PATH中追加%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux） - 终端执行
java -version和javac -version输出一致，且版本 ≥ 11
下载并解压 Maven 二进制包（不推荐用包管理器装）
Homebrew（macOS）、apt（Ubuntu）或 Chocolatey（Windows）装的 Maven 常存在路径权限、版本滞后或settings.xml位置不明确的问题。稳妥做法是：
- 去官网 https://maven.apache.org/download.cgi 下载
apache-maven-X.Y.Z-bin.zip（别下 src 包） - 解压到无空格、无中文路径，例如
C:\tools\apache-maven-3.9.6或~/dev/apache-maven-3.9.6 - 设置
M2_HOME环境变量指向该目录，再把%M2_HOME%\bin（或$M2_HOME/bin）加入PATH - 运行
mvn -v应同时输出 Maven 版本、JDK 版本和 Java home 路径
配置本地仓库与镜像源（避免首次构建卡死）
默认本地仓库在 ~/.m2/repository，首次执行 mvn compile 会尝试从中央仓库下载大量依赖，国内直连极慢甚至超时。必须手动改 conf/settings.xml：
立即学习“Java免费学习笔记（深入）”；
- 找到
D:\m2repo - 在
aliyunmaven * Aliyun Maven https://maven.aliyun.com/repository/public - 改完后删掉
~/.m2/repository（如果已生成空目录），再跑mvn archetype:generate -DgroupId=test -DartifactId=demo -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false验证是否能拉下依赖
IDE 中 Maven 配置常被忽略的细节
IntelliJ 或 Eclipse 即便检测到 mvn 命令，也默认用自己的嵌入式 Maven 或缓存旧版 settings.xml：
- IntelliJ：File → Settings → Build → Build Tools → Maven → 把
Maven home path改为你的M2_HOME路径，User settings file指向你改过的conf/settings.xml，勾选Override - Eclipse：Preferences → Maven → Installations → Add → 选你解压的目录；再进 User Settings，点 “Update Settings”
- IDE 新建项目时若仍报
Plugin execution not covered by lifecycle configuration，说明它没读到你配的镜像或 JDK 版本不匹配，要回退检查mvn -v输出和 IDE 内 Maven 配置是否完全一致
最常卡住的地方不是下载不了依赖，而是 IDE 用了一套 Maven 配置，终端用了另一套——两者 settings.xml、JDK、本地仓库路径不统一，导致构建结果不一致。动手前先跑通终端里的 mvn clean compile，再动 IDE。
