Java多版本共存设置与管理方法

Java多版本共存的核心并非安装难题，而是精准、安全、可复现地控制不同场景下（命令行、IDE开发、Maven/Gradle构建、CI/CD）所使用的JDK版本——推荐Linux/macOS用户首选轻量活跃的SDKMAN!实现动态软链接切换，Windows用户则可用Chocolatey配合定制PowerShell脚本按需生效；同时必须牢记：IDE项目级JDK配置优先于系统环境变量，而PATH顺序、shell初始化文件配置及IDE缓存刷新等细节，往往才是导致版本混乱的真正元凶。

Java 多版本共存不是问题，关键是让 java、javac 命令指向你当前需要的版本，且不互相污染环境变量。手动改 JAVA_HOME 和 PATH 容易出错，推荐用工具管理。

用 SDKMAN! 管理多个 JDK（Linux/macOS 推荐）

SDKMAN! 是轻量、活跃、专为 JVM 生态设计的版本管理器，支持 OpenJDK、Amazon Corretto、Azul Zulu、IBM Semeru 等主流 JDK 发行版。

• 安装只需一行：

  curl -s "https://get.sdkman.io" | bash

  ，然后重启 shell 或运行 source "$HOME/.sdkman/bin/sdkman-init.sh"
• 查看可用 JDK：sdk list java，输出类似 17.0.10-tem、21.0.4-oracle、22.0.2-amzn
• 安装指定版本：sdk install java 21.0.4-oracle（会自动下载、解压、注册）
• 全局切换：sdk default java 21.0.4-oracle；当前 shell 临时切换：sdk use java 17.0.10-tem
• 每个 JDK 安装后都带独立 bin/ 目录，sdk 通过软链接动态调整 java 和 javac 指向，不影响系统原有 JDK

Windows 下用 jEnv 替代方案（或手动 + PowerShell 脚本）

Windows 没有原生 jEnv，但可借助 choco 安装 jdk8、openjdk17、temurin21 等包，再用 PowerShell 脚本快速切换：

• 先用 Chocolatey 安装多个版本：choco install openjdk17 temurin21（默认装在 C:\Program Files\OpenJDK\openjdk-17.0.10-1 类似路径）
• 写一个 set-java.ps1 脚本，内容为：

  $env:JAVA_HOME = "C:\Program Files\Eclipse Adoptium\jdk-21.0.4.7-hotspot"
  $env:PATH = "$env:JAVA_HOME\bin;" + ($env:PATH -replace [regex]::Escape("$env:JAVA_HOME\bin;"), "")

• 执行前需启用脚本策略：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser；之后直接运行 . .\set-java.ps1 即可切换
• 注意：PowerShell 的 $env: 只对当前会话生效，关窗即失效，适合开发时按需切换

IDE 内部 JDK 配置优先于系统环境变量

IntelliJ IDEA、Eclipse、VS Code（Java Extension Pack）都允许为每个项目单独指定 JDK，这个设置比 JAVA_HOME 更具优先级，也更安全。

• IntelliJ：File → Project Structure → Project Settings → Project → Project SDK → 点击 + 添加已安装的 JDK 目录（如 /home/user/.sdkman/candidates/java/current 或 C:\Users\X\.sdkman\candidates\java\21.0.4-oracle）
• Eclipse：Preferences → Java → Installed JREs → Add… → Standard VM → JRE home 填 JDK 解压路径
• VS Code：打开 Java 项目后，按 Ctrl+Shift+P → 输入 “Java: Configure Java Runtime” → 在 “Java Configuration” 页面设置 “Java Runtime” 和 “Test Runtime”
• 重要：Maven/Gradle 构建时若使用 mvn compile 命令行，仍走系统 java，但 IDE 内部编译、调试、运行均以项目配置为准

避免常见陷阱：PATH 顺序、shell 初始化、IDE 缓存

多版本管理失败，90% 出在路径覆盖或缓存未刷新。

• which java 或 where java（Windows）必须返回你预期的 JDK bin 目录，否则说明 PATH 里有更靠前的旧版本
• macOS/Linux 使用 zsh 后，别忘了把 SDKMAN! 初始化语句加到 ~/.zshrc（而非 ~/.bash_profile），否则新终端打不开就找不到 sdk 命令
• IDE 启动时读取的是它启动那一刻的环境变量，改完 JAVA_HOME 后没重启 IDE，项目里看到的还是旧版本
• Maven 的 toolchains.xml 和 Gradle 的 javaToolchains 配置可强制构建使用特定 JDK，与运行时解耦——这点常被忽略，但对 CI/CD 和多目标兼容编译至关重要

真正麻烦的不是装多个 JDK，而是让不同场景（命令行、IDE、CI 构建、容器镜像）各自稳定地绑定到对应版本。工具只是手段，关键是要清楚每个环节到底读的是哪个 JAVA_HOME、哪个 PATH、哪份配置文件。

本篇关于《Java多版本共存设置与管理方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！