JAVA_HOME 应指向 JDK 根目录（如 C:\Program Files\Java\jdk-17.0.2），而非 jre 或 bin 子目录；其下须含 bin、lib 等标准子目录，PATH 仅需添加 %JAVA_HOME%\bin 或 $JAVA_HOME/bin，并通过 echo、where/which 和 javac -version 验证配置。
JAVA_HOME 应该指向 JDK 的根目录，不是 jre 或 bin
很多人把 JAVA_HOME 设成 C:\Program Files\Java\jdk-17\bin，这是错的——bin 目录下没有 lib、jre 等关键子目录，会导致 Maven、Gradle、Tomcat 等工具启动失败，报错类似 The JAVA_HOME environment variable is not defined correctly。
正确做法是：找到你安装的 JDK 完整路径，例如：
C:\Program Files\Java\jdk-17.0.2
这个路径下必须包含 bin、lib、jre（或 conf + legal 等标准子目录）。用命令验证：
- Windows：运行
dir %JAVA_HOME%，确认能看到bin文件夹 - macOS/Linux：运行
ls $JAVA_HOME，检查输出是否含bin和lib
PATH 中只需添加 %JAVA_HOME%\bin（Windows）或 $JAVA_HOME/bin（macOS/Linux）
PATH 的作用是让系统能在任意位置识别 java、javac 命令。它不需要也不应该重复添加 JDK 路径其他部分，更不能硬编码具体版本号（如 C:\...\jdk-17.0.2\bin）——否则换 JDK 就得改 PATH。
立即学习“Java免费学习笔记（深入）”；
推荐写法：
- Windows：
%JAVA_HOME%\bin（注意用英文半角百分号，且不要加引号） - macOS/Linux：
$JAVA_HOME/bin（写在~/.zshrc或~/.bash_profile中，记得执行source ~/.zshrc）
常见错误：
- 把
JAVA_HOME加进 PATH（如%JAVA_HOME%），导致系统试图在 JDK 根目录下找可执行文件，报command not found - PATH 里同时存在多个 JDK 的
bin，顺序靠前的会生效，容易误用旧版本
验证配置是否生效：别只跑 java -version
java -version 只能说明 java 命令可用，但无法验证 JAVA_HOME 是否被正确读取。真正需要检查的是：
-
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux）——输出应为完整 JDK 根路径 -
where java（Windows）或which java（macOS/Linux）——结果应为%JAVA_HOME%\bin\java.exe或$JAVA_HOME/bin/java -
javac -version——确认javac可用，排除 PATH 漏掉bin的情况
如果用 IDE（如 IntelliJ IDEA），还要注意：它可能缓存旧的 JDK 配置，需重启 IDE 并在 Project Structure → SDKs 中手动刷新或重选。
多 JDK 共存时，JAVA_HOME 不是“全局开关”
设置一次 JAVA_HOME 并不能自动切换所有 Java 工具的版本。比如：
- Maven 默认读
JAVA_HOME，但可通过MAVEN_OPTS或pom.xml中的maven-compiler-plugin覆盖 - Gradle 使用自己的
org.gradle.java.home配置，不依赖环境变量 - 某些脚本（如 Spring Boot 的
spring-boot-maven-plugin）会检测当前 shell 的java版本，而非JAVA_HOME
所以，临时切换 JDK 更可靠的方式是：
- Windows：在命令行中先执行
set JAVA_HOME=C:\path\to\jdk-11，再运行构建命令 - macOS/Linux：用
export JAVA_HOME=$(/usr/libexec/java_home -v 11)（配合/usr/libexec/java_home工具）
环境变量只是起点，实际项目中往往要分层控制：系统级设默认值，项目级用工具链显式指定，IDE 单独配 SDK —— 这三者不一致才是常态。
