在Java开发中如何切换JDK版本_JDK环境管理思路解析_技术教程

java -version 和 javac -version 版本不一致表明 JDK 环境混乱：PATH 中的 java 与 JAVA_HOME 指向不同 JDK，导致编译通过但运行时报 UnsupportedClassVersionError；需统一 JAVA_HOME 与 PATH，并同步配置 IDE、Maven、Gradle 等工具。

为什么 `java -version` 和 `javac -version` 显示不同版本

这是 JDK 环境混乱最典型的信号——JAVA_HOME 指向一个 JDK，但 PATH 中的 java 可能来自另一个 JRE 或旧 JDK 的 bin 目录。JVM 运行时用的是 PATH 里第一个找到的 java，而编译器 javac 默认依赖 JAVA_HOME（或自身所在目录的兄弟路径）。两者不一致，项目编译通过但运行报 UnsupportedClassVersionError 就很常见。

检查顺序：先运行 which java（macOS/Linux）或 where java（Windows），确认实际执行的 java 路径
再查 echo $JAVA_HOME（macOS/Linux）或 echo %JAVA_HOME%（Windows），看它是否指向同一 JDK 根目录
若不一致，统一修改：把 JAVA_HOME 设为你要用的 JDK 根目录（如 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），再把 $JAVA_HOME/bin 放到 PATH 最前面

macOS 上用 `brew` 安装多个 JDK 后怎么快速切换

brew install openjdk@11 openjdk@17 openjdk@21 会把不同版本装到 /opt/homebrew/opt/openjdk@xx/libexec/openjdk.jdk，但它们默认不注册进系统 JDK 列表。你需要手动软链或使用 brew 提供的 java 管理命令。

运行 brew install java（仅需一次）会自动安装 java 命令行工具 java 的 wrapper
然后用 sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Li brary/Java/JavaVirtualMachines/openjdk-17.jdk 手动注册，再执行 /usr/libexec/java_home -V 就能看到它了
更轻量的做法：直接在 shell 配置中用函数切换，例如在 ~/.zshrc 里加：

jdk() {
  version=$1
  export JAVA_HOME=$(/usr/libexec/java_home -v"$version");
  export PATH=$JAVA_HOME/bin:$PATH;
}

之后执行 jdk 17 即可切换，无需 root 权限，也避免污染系统级 JDK 注册表。

IDEA 或 Eclipse 中的 JDK 设置和系统环境是两套独立逻辑

IDE 的「Project SDK」和「Project language level」只控制编译和语法检查；而 Maven/Gradle 构建时是否真用该 JDK，取决于它们各自的配置。IDE 界面改了，不代表 mvn compile 就跟着变。

IntelliJ IDEA：设置 → Project → Project SDK 是 IDE 编译器用的；但 Maven 还要看 Settings → Build → Build Tools → Maven → Importing → JDK for importer
Gradle：必须显式指定 org.gradle.java.home，推荐写在项目根目录的 gradle.properties 里：org.gradle.java.home=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
Maven：可在 pom.xml 的 maven-compiler-plugin 中设 17 和 17，但这只约束字节码版本，不改变 javac 执行路径

Windows 上用 `setx` 永久设置 `JAVA_HOME` 容易出错

setx JAVA_HOME "C:\Program Files\Java\jdk-17.0.2" 看似正确，但 Windows 的 setx 不会自动去掉末尾反斜杠，也不处理空格路径中的引号嵌套问题。更麻烦的是，它只影响新打开的命令行窗口，旧窗口和已启动的 IDE 不会刷新。

推荐用「系统属性 → 高级 → 环境变量」图形界面操作：新建用户变量 JAVA_HOME，值填完整路径（不含 \bin），再编辑 PATH，新增 %JAVA_HOME%\bin
验证：打开全新 CMD，执行 echo %JAVA_HOME% 和 java -version，二者必须匹配
如果用了 JetBrains Toolbox 启动 IDEA，记得重启 Toolbox 本身——它缓存了环境变量，不重启不会读取新设置

真正麻烦的不是换版本，而是每个环节（shell、IDE、构建工具、容器镜像、CI 脚本）都可能各自维护一套 JDK 路径。漏掉任意一环，就可能出现“本地跑得通，CI 报错”或者“IDE 不报错，打包失败”的情况。