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 /Library/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 就跟着变。
立即学习“Java免费学习笔记（深入）”；
- 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中设<source>17</source>和<target>17</target>，但这只约束字节码版本，不改变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 不报错，打包失败”的情况。
