核心思路是分层控制：系统级统一默认、项目级按需隔离、构建与运行时显式锁定；命令行由path决定java路径，maven/gradle编译目标由配置文件显式指定，ide中project sdk、language level和编译器目标须三者一致，且均需与pom.xml中maven.compiler.source/target严格匹配。
核心思路是分层控制：系统级统一默认、项目级按需隔离、构建与运行时显式锁定。不能只靠改一个 JAVA_HOME 试图让所有程序服从同一版本。
一、明确各层级的Java控制权
不同环节读取Java的方式不同，冲突往往源于“你以为它用这个，其实它用那个”：
-
命令行（CMD/PowerShell）：完全由 PATH 决定调用哪个
java.exe；JAVA_HOME 仅作辅助，不参与执行 -
Maven/Gradle：启动脚本会读取当前shell中的
java命令路径，但编译目标（如字节码版本）由pom.xml或build.gradle显式指定，和系统JDK无关 - IDE（如IntelliJ IDEA）：Project SDK 控制代码补全和语法检查；Build process 可能沿用系统 PATH 或单独配置 JDK；Run Configuration 还可再指定 JRE —— 三者可不一致
-
Spring Boot 打包插件：其自身 class 是由 Maven 运行时的 JDK 加载的，若插件要求 Java 17，而你用 Java 8 启动 Maven，就会报
class file version 61.0错误
二、推荐实用配置策略
根据使用场景选择，不追求“全局唯一”，而追求“按需准确”：
-
日常开发以 SDKMAN! 为主（Windows/macOS/Linux 通用）：
安装后执行sdk install java 17.0.2-tem和sdk install java 8.0.392-amzn，再用sdk use java 17.0.2-tem切换当前终端的 JDK。此时java -version、javac -version、$JAVA_HOME全部自动同步，且不影响其他终端 -
若必须用 Windows 系统变量管理多个版本：
为每个 JDK 创建独立变量（如JAVA8_HOME、JAVA17_HOME），再设一个JAVA_HOME指向%JAVA17_HOME%；PATH 中只写%JAVA_HOME%\bin；切换时只需修改JAVA_HOME的值，无需动 PATH -
避免 Oracle 自动注入的 javapath 干扰：
检查 PATH 中是否含C:\Program Files (x86)\Common Files\Oracle\Java\javapath，如有，把它移到最底部或直接删除——该目录内容会被新装 JDK 覆盖，极易导致版本错乱
三、关键验证点（缺一不可）
每次配置后，务必在**新开命令行窗口**中逐项确认：
-
where java（Windows）或which java（macOS/Linux）→ 看实际执行路径是否为你期望的 JDKbin目录 -
java -version和javac -version→ 输出主版本号必须一致（如都是 17） -
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux）→ 必须指向该 JDK 根目录，且不能是空或错误路径 -
mvn -v→ 查看 Maven 启动所用的 Java 路径，应与上面三项一致；否则说明 Maven 脚本被硬编码了 JDK
四、IDE 和构建工具必须手动对齐
环境变量只是基础，IDE 和构建工具不会自动继承全部逻辑：
-
IntelliJ IDEA：File → Project Structure → Project 中设置 Project SDK 和 Project language level；再进 Settings → Build → Compiler → Java Compiler → Target bytecode version，必须与
maven.compiler.target值一致 -
Maven 项目：在
pom.xml中强制声明编译器插件，例如：<maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target>
不要依赖java.version属性，它不控制编译行为 -
Docker 或 CI 环境：显式指定基础镜像，如
FROM openjdk:17-jdk-slim，不在容器内依赖宿主机 JAVA_HOME
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
