IDEA中如何查看当前工程的JDK版本？

Question

在使用IntelliJ IDEA开发Java项目时，如何准确查看当前工程所使用的JDK版本？部分开发者在导入Maven或Gradle项目后，发现代码提示或编译报错与预期JDK特性不符，怀疑IDE未正确识别项目JDK版本。尽管Project Structure中配置了JDK，但模块级或SDK设置可能覆盖全局配置，导致实际运行版本与预期不一致。此外，pom.xml或build.gradle中的Java版本声明也可能与IDE显示不同，引发困惑。如何通过IDEA界面快速确认当前工程及各模块实际生效的JDK版本？

Answer 1

在IntelliJ IDEA中准确查看Java项目JDK版本的完整指南

1. 从IDEA界面快速识别当前工程JDK版本（基础层面）

对于刚导入项目的开发者，最直观的方式是通过IDEA主界面右下角查看当前项目使用的JDK版本：

• 打开任意Java文件，IDEA右下角会显示类似“JDK 11”或“Java 17”的标签。
• 点击该标签可快速切换项目SDK，也可进入“Project Structure”进行更详细配置。
• 若未显示，可通过 View → Status Bar Widgets → Project SDK 启用该提示。

此方式适用于快速确认，但无法判断模块级覆盖或构建工具声明差异。

2. 检查Project Structure中的全局与模块级JDK设置（配置层级分析）

进入 File → Project Structure (Ctrl+Alt+Shift+S)，可分层查看JDK配置：

配置项	路径	说明
Project SDK	Project Settings → Project	定义整个项目的默认JDK
Project language level	Project Settings → Project	影响语法检查和代码补全
Module SDK	Project Settings → Modules	可为每个模块单独指定JDK，优先级高于项目级
Language level per module	Modules → Sources tab	控制单个模块的语言特性支持

常见问题：即使Project SDK设为JDK 17，若某模块仍使用JDK 8作为SDK，则该模块不支持var、record等新特性。

3. 验证Maven/Gradle构建文件中的Java版本声明（构建工具一致性）

构建工具的配置可能与IDE设置脱节，需手动核对：

<!-- pom.xml 示例 -->
<properties>
    <java.version>17</java.version>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
</properties>

// build.gradle 示例
java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

注意：这些配置仅影响编译输出，IDEA是否同步取决于是否启用了自动导入。

4. 自动同步机制与常见脱节场景（深度排查）

IDEA支持自动从构建文件同步JDK设置，但以下情况可能导致失效：

1. 首次导入项目时未勾选“Import Maven projects automatically”
2. 手动修改了Project Structure但未重新加载Maven/Gradle
3. 多模块项目中部分模块未正确继承父POM的Java版本
4. 本地缺少构建文件指定的JDK版本
5. 使用了自定义toolchain（如maven-toolchains-plugin）
6. Gradle项目未启用“Use Gradle from”外部安装而非wrapper
7. IDE缓存异常导致显示旧版本
8. 多个JDK安装路径存在命名冲突（如adoptopenjdk与temurin）
9. 操作系统环境变量JAVA_HOME与IDE配置不一致
10. 远程开发场景下本地IDE与服务器JDK不匹配

建议定期执行“Reload All Maven Projects”或“Refresh Gradle Project”以保持同步。

5. 使用命令行与API验证实际编译行为（终极验证手段）

当怀疑IDE显示不准时，可通过外部手段验证：

# 查看Maven实际使用的Java版本
mvn -version

# 编译并输出详细信息
mvn compile -X | grep "sourceLevel\|targetLevel"

# 对Gradle项目
./gradlew --info compileJava

此外，可在代码中插入测试语句：

System.out.println(System.getProperty("java.version"));
System.out.println(System.getProperty("java.home"));

运行该代码片段，输出结果反映的是JVM实际运行版本，不受IDE语法提示误导。

6. 可视化诊断流程图（综合排查路径）

graph TD A[发现语法错误或特性不可用] --> B{检查IDE右下角JDK显示} B --> C[进入Project Structure] C --> D[确认Project SDK与Language Level] D --> E[检查各Module的SDK设置] E --> F{是否与预期一致?} F -- 否 --> G[调整模块SDK并应用] F -- 是 --> H[检查pom.xml或build.gradle] H --> I[确认source/target compatibility] I --> J[重新导入Maven/Gradle项目] J --> K[清理IDE缓存: File → Invalidate Caches] K --> L[重启IDE并验证] L --> M[必要时手动绑定JDK路径]

该流程覆盖了从表象到根因的系统性排查路径。