Java多版本JDK共存环境如何正确搭建

哈喽！今天心血来潮给大家带来了《Java多版本JDK共存环境如何正确搭建》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

确认JDK多版本共存需验证java -version与which java是否一致，排查PATH残留旧路径；macOS用/usr/libexec/java_home -V查看并切换，Linux用update-alternatives注册全工具链，IDE和构建工具须单独配置对应JDK。

确认系统是否已安装多个JDK版本

很多开发者以为装了几个 jdk-11、jdk-17、jdk-21 就算共存成功，其实只是“物理存在”，没被系统识别或切换使用。关键看 java -version 和 which java 输出是否与预期一致。常见错误是：PATH 里残留旧 JDK 的 bin 路径，导致无论怎么改 JAVA_HOME 都不生效。

实操建议：

• 运行 ls /Library/Java/JavaVirtualMachines/（macOS）或 dir "C:\Program Files\Java\"（Windows）确认实际安装路径
• 逐个执行 /path/to/jdk-17/bin/java -version 验证各版本能否独立运行
• 用 /usr/libexec/java_home -V（macOS）或 update-alternatives --list java（Ubuntu）查看系统级 JDK 注册列表

macOS 下用 java_home 切换默认 JDK

macOS 自带的 /usr/libexec/java_home 是最轻量、最可靠的切换方式，它不依赖 shell 配置文件重载，也不修改全局 PATH，只动态生成路径。很多人手动改 ~/.zshrc 中的 JAVA_HOME，却忘了同步更新 PATH 里的 $JAVA_HOME/bin，结果 java 命令仍调用旧版本。

实操建议：

• 查可用版本：/usr/libexec/java_home -V，注意输出中每行开头的版本号和路径
• 临时切换（当前终端有效）：export JAVA_HOME=$(/usr/libexec/java_home -v 17)
• 永久切换（推荐按项目设置）：在项目根目录下加 .env 文件，用 direnv 加载；或在 IDE 运行配置中单独指定 JAVA_HOME
• 避免写死路径，比如不要用 export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，它易过期且不可移植

Linux（Ubuntu/Debian）用 update-alternatives 管理多 JDK

Linux 发行版通常不自带 java_home，但 update-alternatives 是标准方案。问题在于：很多人只执行 sudo update-alternatives --install 添加选项，却漏掉 --config java 手动选择，或者没同时注册 javac、jar 等关联命令，导致编译时用的是 JDK 17，打包时却调了 JDK 11 的 jar。

实操建议：

• 为每个 JDK 安装项注册全部工具链：

  sudo update-alternatives --install /usr/bin/java java /opt/jdk-17/bin/java 170 \
    --slave /usr/bin/javac javac /opt/jdk-17/bin/javac \
    --slave /usr/bin/jar jar /opt/jdk-17/bin/jar

• 切换前先确认所有关联命令已注册：update-alternatives --list java 和 update-alternatives --list javac 应返回相同优先级列表
• 切换后验证：java -version、javac -version、readlink -f $(which java) 三者必须指向同一 JDK 根目录

IDE 和构建工具如何避开全局 JDK 冲突

即使终端里 java -version 显示正确，IntelliJ、VS Code 或 Maven 仍可能用错 JDK —— 因为它们往往忽略 shell 的 JAVA_HOME，而读取自身配置或 pom.xml 中的 maven-compiler-plugin 设置。典型现象是：命令行编译成功，IDE 报 “Unsupported class file major version 65”（即用了 JDK 21 编译，但 IDE 默认用了 JDK 11 运行）。

实操建议：

• IntelliJ：File → Project Structure → Project Settings → Project → SDK，选对应 JDK；再进 Modules → Sources → Language level，确保与 SDK 匹配
• Maven：在 pom.xml 中显式声明编译目标：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.11.0</version>
    <configuration>
      <source>17</source>
      <target>17</target>
    </configuration>
  </plugin>

• Gradle：在 gradle.properties 中设 org.gradle.java.home=/path/to/jdk-17，比依赖 JAVA_HOME 更可靠

环境真正稳定下来，不在于装了多少个 JDK，而在于每次执行 java、javac、IDE 启动、Maven 构建时，背后调用的二进制文件是否来自你明确指定的那个版本。最容易被忽略的是：构建工具和 IDE 的 JDK 设置彼此独立，且常常默认值滞后于系统最新安装版本。

本篇关于《Java多版本JDK共存环境如何正确搭建》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！