在Java里切换默认JDK版本的方法有哪些_Java版本管理思路说明_技术教程

最干净的全局切换方式是用 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 17
sudo 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 命令仍可能调用旧版本：

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 的是 11，编译出的字节码仍是 class file version 55，跟运行时 JDK 版本无关。

构建工具显式指定 JDK（Maven / Gradle）

Maven 和 Gradle 可强制使用特定 JDK 编译，不依赖环境变量，适合 CI 或多版本共存场景：

Maven：在 pom.xml 中配置插件：


  org.apache.maven.plugins
  maven-compiler-plugin
  3.11.0
  
    21
    21
    21

Gradle：在 build.gradle 中：
```
java {
  toolchain {
    languageVersion = JavaLanguageVersion.of(17)
  }
}
```
这会自动匹配本地已安装的 JDK 17，若找不到则报错，不会降级。

注意：是 Maven 3.8+ 强烈推荐的选项，它启用跨版本编译（如用 JDK 21 编译兼容 JRE 11 的 class），比单纯设 / 更安全。Gradle 的 toolchain 同理，本质是让构建过程解耦于当前 JAVA_HOME。

真正麻烦的从来不是“怎么切”，而是切完之后——java -version、javac -version、IDE 编译器、Maven/Gradle 构建、运行时容器（如 Spring Boot 的 java -jar）、甚至 Dockerfile 里的 FROM openjdk:17-jre-slim，这五处可能各自用着不同 JDK。漏掉任何一环，都可能在打包成功后运行时报 UnsupportedClassVersionError。