17370845950

必须安装JDK（非JRE）并正确配置JAVA_HOME和PATH，确保javac与java版本一致且可调用；Maven版本需与JDK版本兼容，否则构建失败。

使用 Maven 前，必须确保 Java 运行环境已正确安装并配置，因为 Maven 本身是用 Java 编写的，其所有命令（如 mvn compile、mvn package）都依赖 JVM 才能执行。没有可用的 JDK，Maven 将无法启动。

必须安装 JDK（不是 JRE）

Maven 构建过程涉及编译源码、运行插件、执行测试等操作，这些都需要 Java 编译器（javac）和运行时支持。JRE 只含运行环境，不含编译工具，因此不能满足 Maven 要求。

• 推荐使用 JDK 8 或更高版本（Maven 3.6.3+ 官方支持 JDK 11/17；Maven 4.x 已要求 JDK 17+）
• 可通过终端运行 javac -version 和 java -version 验证是否安装了 JDK（二者版本号应一致或兼容）
• 注意：仅设置 JAVA_HOME 指向 JRE 目录会导致 mvn 报错 “The JAVA_HOME environment variable is not defined correctly”

JAVA_HOME 环境变量必须正确配置

Maven 启动脚本（mvn 或 mvn.bat）会优先读取 JAVA_HOME 来定位 Java 安装路径。若未设置或指向错误，Maven 会尝试从系统 PATH 中查找 java，但可能版本不匹配或缺失 javac。

• Windows 示例：set JAVA_HOME=C:\Program Files\Java\jdk-17.0.2
• macOS / Linux 示例：export JAVA_HOME=$(/usr/libexec/java_home -v 17)（推荐用 java_home 命令自动定位）
• 验证方式：在终端输入 echo $JAVA_HOME（Linux/macOS）或 echo %JAVA_HOME%（Windows），确认输出为 JDK 根目录

PATH 中需包含 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）

确保 java 和 javac 命令可在任意目录下直接调用，这是 Maven 内部调用 Java 工具链的前提。

• Windows：将 %JAVA_HOME%\bin 添加到系统 PATH
• macOS/Linux：在 ~/.zshrc 或 ~/.bash_profile 中添加 export PATH=$JAVA_HOME/bin:$PATH
• 配置后重启终端，再执行 which java 和 which javac，确认路径指向 JDK 的 bin 目录

Maven 版本与 Java 版本需兼容

不同 Maven 版本对 Java 有明确最低要求，强行混用会导致构建失败或插件异常。例如：

• Maven 3.5.x 最低要求 JDK 8，但不完全支持 JDK 17 的新特性（如密封类）
• Maven 3.9.0+ 正式支持 JDK 21（LTS），但部分老插件可能尚未适配
• 建议查阅 Maven 官方 Requirements 页面，按实际 JDK 版本选择对应 Maven 版本

Java 是 Maven 的底层支撑，不是可选依赖——它决定了你能用什么语法写代码、哪些插件能正常工作、甚至整个项目的生命周期能否顺利执行。环境没配好，连 mvn -v 都会失败，更别说构建项目了。