JAVA_HOME 应指向 JDK 根目录而非 bin 或 JRE 目录，因构建工具、IDE 和框架依赖根目录下的 lib、jre、include 等子目录；PATH 中避免重复添加 %JAVA_HOME%\bin 以防版本冲突；验证需通过 Maven/Gradle/IDE 等实际使用者输出确认，而非仅看 java -version；多 JDK 场景下 JAVA_HOME 是全局静态变量，应配合 toolchains、SDKMAN! 或 IDE 项目级配置实现版本隔离。
JAVA_HOME 应该指向 JDK 根目录，不是 JRE 或 bin 目录
很多人把 JAVA_HOME 设成 C:\Program Files\Java\jdk-17\bin，这是错的。JDK 的 bin 目录里只有可执行文件（如 java.exe、javac.exe），而构建工具（Maven、Gradle）、IDE（IntelliJ、Eclipse）和部分框架（Spring Boot DevTools）依赖的是 lib、jre、include 等子目录下的资源 —— 这些都在 JDK 根目录下，不在 bin 里。
正确路径示例：
- Windows：
C:\Program Files\Java\jdk-17.0.2 -
macOS：
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home - Linux：
/usr/lib/jvm/java-17-openjdk-amd64（OpenJDK 路径因发行版而异）
PATH 中不要重复添加 %JAVA_HOME%\bin，除非你手动管理 PATH
很多教程教你在 PATH 里加 %JAVA_HOME%\bin，这本身没错，但容易引发冲突：
- 如果你已通过系统包管理器（如
apt install openjdk-17-jdk）安装 JDK，它通常会把/usr/bin/java符号链接到对应版本，此时再手动在PATH前置$JAVA_HOME/bin可能导致版本混乱 - 某些 IDE（如 IntelliJ）或构建工具（如 Gradle Wrapper）会忽略系统
PATH，只认JAVA_HOME；而命令行运行java -version却走PATH—— 两者不一致时，你会看到「IDE 用的是 JDK 17，终端却显示 JDK 11」 - macOS 上如果用了
brew install openjdk，默认不会写入PATH，但JAVA_HOME必须设为/opt/homebrew/opt/openjdk（软链接），否则javac找不到tools.jar等内部类路径
验证 JAVA_HOME 是否生效：别只信 java -version
java -version 只反映当前 PATH 下第一个 java 可执行文件，不体现 JAVA_HOME 设置是否被其他程序识别。真正要验证，得看谁在用它：
立即学习“Java免费学习笔记（深入）”；
- Maven：运行
mvn -v，输出中会明确写出Java version: 17.0.2, vendor: Oracle Corporation, home: /path/to/jdk-17.0.2—— 这个home就是它读到的JAVA_HOME - Gradle：执行
gradle --version，若显示JVM: 17.0.2 (Oracle Corporation 17.0.2+8-86)且路径匹配你的JAVA_HOME，说明生效 - IntelliJ：File → Project Structure → Project → Project SDK，应显示你设的 JDK 路径；同时 Terminal 插件启动的 shell 也应继承该环境变量（需勾选「Shell integration」）
- 命令行检查：
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），再确认该路径下存在lib/tools.jar（JDK 9+ 已移除，改用jdk.compiler模块，但目录结构仍需完整）
多 JDK 共存时，JAVA_HOME 是全局开关，不是版本管理器
JAVA_HOME 是一个静态环境变量，不能自动随项目切换 JDK 版本。如果你同时开发 Java 8 和 Java 17 的项目，仅靠改 JAVA_HOME 很容易出错：
- IDE 通常支持 per-project JDK 配置，优先级高于
JAVA_HOME；但 Maven 的toolchains.xml或 Gradle 的javaToolchain配置才是跨环境稳定方案 - macOS/Linux 推荐用
SDKMAN!（sdk install java 17.0.2-tem+sdk use java 17.0.2-tem），它会动态更新JAVA_HOME和PATH，且作用于当前 shell 会话 - Windows 上
choco install openjdk17后，每个版本会注册独立的JAVA_HOME_x64_17变量，需配合批处理脚本切换 —— 直接硬改系统级JAVA_HOME容易被其他软件覆盖
最常被忽略的一点：某些老版本 Tomcat（如 9.0.65 之前）在启动脚本里会重写 JAVA_HOME，即使你设对了，它也可能悄悄替换成自带的 JRE。遇到启动失败又查不到原因时，先看 catalina.sh/bat 开头几行有没有强制赋值逻辑。
