最干净的全局切换方式是用 update-alternatives 注册并配置 JDK；若未注册需手动添加，注意路径和优先级；还需同步设置 JAVA_HOME 和 PATH、IDE 项目 SDK、Maven/Gradle 编译工具链，并验证五处一致性。
用 update-alternatives 切换系统级默认 JDK（Linux/macOS）
Linux 和部分 macOS（通过 Homebrew 安装的 OpenJDK）会把不同 JDK 注册进 update-alternatives，这是最干净的全局切换方式。执行前先确认 JDK 已安装并被识别：
sudo update-alternatives --config java
如果提示 no alternatives for java，说明 JDK 没注册进去，需手动添加：
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk-17/bin/java 17sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk-17/bin/javac 17
注意：路径要替换成你本地真实的 JDK 安装路径（如 /opt/java/jdk-21），优先级数字（如 17）越大，--config 时默认选中权重越高。改完后运行 java -version 验证。
在 Shell 中临时覆盖 JAVA_HOME 和 PATH（所有平台通用）
这是最灵活、无权限要求的方式，适合单次构建或调试不同版本项目。关键不是只改 JAVA_HOME，而是必须同步更新 PATH，否则 java 命令仍可能调用旧版本：
立即学习“Java免费学习笔记（深入）”；
- Linux/macOS：
export JAVA_HOME=/path/to/jdk-11 export PATH=$JAVA_HOME/bin:$PATH
- Windows（CMD）：
set JAVA_HOME=C:\Program Files\Java\jdk-17 set PATH=%JAVA_HOME%\bin;%PATH%
常见坑：java -version 显示旧版本，但 $JAVA_HOME/bin/java -version 是新版本 → 说明 PATH 没生效或顺序不对；mvn compile 仍用错 JDK → Maven 默认读 JAVA_HOME，但某些插件（如 maven-compiler-plugin）还依赖 source/target 配置，得额外检查。
IDE 内独立配置 JDK（IntelliJ / Eclipse / VS Code）
IDE 不继承系统默认 JDK，每个项目可指定不同 SDK。但容易混淆的是「编译器级别」和「运行时 JDK」是两个开关：
- IntelliJ：
File → Project Structure → Project设Project SDK和Project language level；再进Modules → Sources确认Language level一致 - Eclipse：
Project Properties → Java Build Path → Libraries替换JRE System Library；再进Java Compiler关闭Use compliance from execution environment手动设Compiler compliance level - VS Code + Extension Pack for Java：在项目根目录加
.vscode/settings.json："java.configuration.runtimes": [ { "name": "JavaSE-17", "path": "/path/to/jdk-17" } ]
重点：即使 IDE 显示用了 JDK 21，如果 pom.xml 里 maven-compiler-plugin 的 <source></source> 是 11，编译出的字节码仍是 class file version 55，跟运行时 JDK 版本无关。
构建工具显式指定 JDK（Maven / Gradle）
Maven 和 Gradle 可强制使用特定 JDK 编译，不依赖环境变量，适合 CI 或多版本共存场景：
- Maven：在
pom.xml中配置插件：<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.11.0</version> <configuration> <source>21</source> <target>21</target> <release>21</release> <!-- 推荐，避免引用高版本 API --> </configuration> </plugin> - Gradle：在
build.gradle中：java { toolchain { languageVersion = JavaLanguageVersion.of(17) } }这会自动匹配本地已安装的 JDK 17，若找不到则报错，不会降级。
注意：<release></release> 是 Maven 3.8+ 强烈推荐的选项，它启用跨版本编译（如用 JDK 21 编译兼容 JRE 11 的 class），比单纯设 <source></source>/<target></target> 更安全。Gradle 的 toolchain 同理，本质是让构建过程解耦于当前 JAVA_HOME。
真正麻烦的从来不是“怎么切”，而是切完之后——java -version、javac -version、IDE 编译器、Maven/Gradle 构建、运行时容器（如 Spring Boot 的 java -jar）、甚至 Dockerfile 里的 FROM openjdk:17-jre-slim，这五处可能各自用着不同 JDK。漏掉任何一环，都可能在打包成功后运行时报 UnsupportedClassVersionError。
