Java多版本JDK切换全攻略

本文深入解析了在多JDK版本共存环境下高效、可靠切换Java开发环境的核心方法，重点推荐Linux/macOS使用sdkman实现一键列表、安装、临时切换与全局默认设置，Windows则结合choco安装与IDE或项目级配置（如IntelliJ的Project SDK、.java-version文件）规避JAVA_HOME误配导致的编译失败；同时揭示了JAVA_HOME错位引发的典型问题（如Unsupported class file major version、var关键字无法识别），并厘清Gradle（支持toolchain和org.gradle.java.home）与Maven（依赖JAVA_HOME及插件配置）在JDK绑定逻辑上的关键差异，帮助开发者彻底解决环境混乱、构建不一致等痛点。

用 sdkman 管理多个 JDK 版本最省心

Linux/macOS 下推荐直接用 sdkman，它专为 JVM 生态设计，比手动改 JAVA_HOME 可靠得多。安装后执行：

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

sdk list java<br>sdk install java 17.0.1-tem<br>sdk install java 21.0.1-tem<br>sdk use java 17.0.1-tem

Windows 上用 choco + 手动配置环境变量更可控

PowerShell 中用 choco install openjdk17 openjdk21 装好后，JDK 默认装在 C:\Program Files\OpenJDK\ 下带版本号的子目录里。关键不是改系统级 JAVA_HOME，而是：

• 在项目根目录下放一个 .java-version 文件，内容写 17.0.1-tem（需配合 sdkman 或 jenv）
• 或者用 IDE（如 IntelliJ）单独为每个项目指定 Project SDK，这比系统变量优先级更高
• 若必须命令行切换，建议写小脚本封装 set JAVA_HOME=C:\Program Files\OpenJDK\openjdk-17.0.1 和 set PATH=%JAVA_HOME%\bin;%PATH%，避免手误漏掉 bin

JAVA_HOME 指向错误是常见编译/运行失败根源

很多构建工具（Maven、Gradle）和 IDE 都依赖 JAVA_HOME，但它们不读 PATH 里的 java。典型现象包括：
— mvn compile 报错 Unsupported class file major version 65（实际是用了 JDK 21 编译，但 JAVA_HOME 指向 JDK 17）
— IntelliJ 提示 “Cannot resolve symbol ‘var’” 却明明开了语言级别 17+（因为 Project SDK 和 JAVA_HOME 不一致）
验证方式很简单：

echo $JAVA_HOME  # Linux/macOS<br>echo %JAVA_HOME%  # Windows<br>java -version<br>$JAVA_HOME/bin/java -version  # 严格对比输出

Gradle 和 Maven 的 JDK 绑定逻辑容易被忽略

这两个工具会主动探测 JDK，但行为不同：
— Gradle 从 gradle.properties 里的 org.gradle.java.home 读取，没配就 fallback 到 JAVA_HOME；如果项目用了 toolchain，还会覆盖这个值：

java {<br>    toolchain {<br>        languageVersion = JavaLanguageVersion.of(17)<br>    }<br>}

本篇关于《Java多版本JDK切换全攻略》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！