IDE使用项目/模块/全局SDK配置而非系统PATH，java -version仅反映PATH首个Java版本；常见错位原因包括缓存旧JDK、XML硬编码路径、运行配置覆盖及Gradle/Maven多层版本控制。
IDE 读取的是项目级或 SDK 级 Java 版本配置，不是系统 PATH
命令行执行 java -version 显示的是当前 PATH 中第一个 java 可执行文件的版本，而 IDE（如 IntelliJ IDEA、Eclipse）默认不依赖系统环境变量，而是按以下优先级决定实际编译/运行用的 JDK：
- 项目设置中显式指定的 Project SDK（最高优先级）
- 模块（Module）单独配置的 Language Level 和 SDK
- 全局 IDE 默认 SDK（在
File → Project Structure → Platform Settings → SDKs中管理） - 仅当以上全未配置时，部分 IDE 才会 fallback 到
JAVA_HOME或PATH
IntelliJ IDEA 中常见版本错位场景
即使你已更新系统 JDK 并修改了 JAVA_HOME，IDEA 仍可能沿用旧版本，原因包括：
- 新建项目时勾选了 “Use project JDK” 但没点开下拉框确认，实际选中的是缓存列表里的旧 JDK（比如
jdk-11.0.2而非jdk-17.0.1） -
.idea/misc.xml或.idea/modules.xml中硬编码了旧 JDK 路径，例如：<component name="ProjectRootManager" project-jdk-name="corretto-11" /> - 运行配置（Run Configuration）里单独设置了 JRE，覆盖了项目 SDK（检查
Edit Configurations → JRE下拉项） - Gradle/Maven 项目中，
sourceCompatibility或maven-compiler-plugin配置了低版本，导致编译通过但运行时用的是高版本 JDK——这会引发IncompatibleClassChangeError等隐性问题
验证和统一版本的实操步骤
别只看菜单栏显示，要查真实生效路径：
- 在 IDEA 中打开
Help → Find Action（快捷键Ctrl+Shift+A），输入 “Switch Boot JDK”，可强制切换 IDE 自身运行所用的 JDK（影响插件兼容性） - 在任意 Java 文件中写
System.out.println(System.getProperty("java.home"));并运行，输出路径即为当前运行时实际使用的 JDK 根目录 - 检查终端是否在 IDE 内置 Terminal 中启动：内置 Terminal 默认继承 IDE 的环境变量，而非系统 shell 的
PATH；若需测试真实系统环境，应另开系统终端 - Mac 用户注意：
/usr/bin/java是 Apple 的 stub，它会根据/Library/Java/JavaVirtualMachines/下可用 JDK 和java_home -V输出顺序动态代理，容易造成“命令行版本跳变”
Gradle 项目里 Java 版本的三重控制点
一个 Gradle 项目可能同时受三个层级约束，任一不一致就会导致 IDE 显示与构建行为不符：
立即学习“Java免费学习笔记（深入）”；
-
gradle.properties中的org.gradle.java.home—— 指定 Gradle daemon 启动用的 JDK -
build.gradle中的java.toolchain.version = "17"（Gradle 17+）或sourceCompatibility = JavaVersion.VERSION_17—— 控制编译器行为 - IDE 导入项目时是否勾选 “Delegate IDE build/run actions to Gradle”：若未勾选，IDE 用自己的编译器和 SDK 编译，完全绕过
build.gradle配置
最稳妥的做法是：关闭 Delegate，先确保 IDEA 的 Project SDK 和 Module SDK 都设为所需版本；再开启 Delegate，让 IDE 使用 Gradle 的 toolchain 配置，并把 java.toolchain.version 设为明确数字（如 "17"），避免字符串匹配失败。
