JAVA_HOME必须指向JDK根目录（含bin、lib、jre），不可填bin子目录；需通过系统环境变量设置并重启终端验证，且Docker/CI中须显式声明。
确认 JDK 安装路径后才能设 JAVA_HOME
JAVA_HOME 不是随便填个路径就行，它必须指向 JDK 的根目录（不是 JRE，也不是 bin 子目录）。常见错误是填成 C:\Program Files\Java\jdk-17.0.1\bin —— 这会导致后续工具（如 Maven、Gradle）找不到 javac 或 tools.jar。
正确做法是：打开安装目录，找到包含 bin、lib、jre 三个子目录的父文件夹。例如：
C:\Program Files\Java\jdk-17.0.1 ← 正确 C:\Program Files\Java\jdk-17.0.1\bin ← 错误
- 在命令行运行
where javac（Windows）或which javac（macOS/Linux），反向定位 JDK 根路径 - 如果用 IDE 自带 JDK（如 IntelliJ 内置 Corretto），别直接抄 IDE 设置里的路径——它可能指向内部 bundle，不适用于外部构建工具
- 多版本共存时，JAVA_HOME 应与
java -version输出的版本一致，否则 Maven 编译可能用错 JDK
Windows 上通过系统属性设置 JAVA_HOME（非临时变量）
用 set JAVA_HOME=... 只在当前 CMD 窗口生效，重启就丢。真正生效要进「系统属性 → 高级 → 环境变量」，在「系统变量」里新建：
- 变量名：
JAVA_HOME - 变量值：
C:\Program Files\Java\jdk-17.0.1（注意：不要加尾部反斜杠） - 接着编辑
Path系统变量，新增一条：%JAVA_HOME%\bin
改完必须重启终端（CMD/PowerShell）或整个 IDE，否则 echo %JAVA_HOME% 仍为空或旧值。验证命令：echo %JAVA_HOME% 和 java -version 应能对上。
立即学习“Java免费学习笔记（深入）”；
macOS/Linux 用户注意 shell 配置文件的选择
不是所有 shell 都读 ~/.bash_profile。zsh 已是 macOS 默认 shell（从 Catalina 开始），它优先读 ~/.zshrc；Ubuntu 20.04+ 默认用 bash，但某些桌面环境会绕过 ~/.bashrc。
稳妥做法：在对应 shell 启动文件末尾添加：
export JAVA_HOME=$(/usr/libexec/java_home -v 17) # macOS 推荐，自动找最新 JDK 17 # 或手动指定： export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home export PATH=$JAVA_HOME/bin:$PATH
-
/usr/libexec/java_home是 macOS 原生工具，比硬编码路径更可靠 - Linux 用户若用
apt install openjdk-17-jdk，路径通常是/usr/lib/jvm/java-17-openjdk-amd64（Debian/Ubuntu）或/usr/lib/jvm/java-17-openjdk（RHEL/Fedora） - 修改后执行
source ~/.zshrc（或对应文件），再运行echo $JAVA_HOME验证
IDE 和构建工具可能忽略系统 JAVA_HOME
IntelliJ、Eclipse、VS Code 的 Java 插件通常用自己的 JDK 配置，不继承系统 JAVA_HOME。Maven 默认用 java 命令所在路径，但 mvn -v 显示的 Java version 可能和 $JAVA_HOME 不一致。
- IntelliJ：File → Project Structure → Project → Project SDK → 选中已配置的 JDK（不是靠 JAVA_HOME 自动识别）
- Maven：检查
mvn -v输出的 “Java version” 和 “Java home”，若不一致，说明MAVEN_OPTS或pom.xml中指定了toolchain - Gradle：
gradle --version显示的 JVM 路径由启动它的 Java 决定，不是 JAVA_HOME —— 用export JAVA_HOME=...后再运行 gradle 才有效
最易被忽略的一点：Docker 构建、CI 流水线（如 GitHub Actions）完全隔离宿主机环境，JAVA_HOME 必须在 Dockerfile 或 workflow 文件里显式声明，系统设置毫无作用。
