Java多版本共存关键在于精准控制java/javac指向,推荐用SDKMAN!(Linux/macOS)或PowerShell脚本(Windows),IDE项目级配置优先于系统环境变量,需注意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 更具优先级,也更安全。
立即学习“Java免费学习笔记(深入)”;
- 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)必须返回你预期的 JDKbin目录,否则说明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、哪份配置文件。










