Gradle java块与IntelliJ IDEA项目结构中JDK版本的区别解析

核心差异：构建约束 vs 本地开发适配 #

两者本质是两个维度的配置，一个管项目构建的全局规则，一个管IDE本地的开发体验：

1. Gradle java块的版本（sourceCompatibility/targetCompatibility） #

这是项目的硬构建约束，不管用IDE还是命令行执行gradle build，所有构建流程都会严格遵循：

• sourceCompatibility：限制代码不能使用指定Java版本以上的语法特性（比如设为1.8就不能用var、部分Stream API新特性），编译时会直接拦截不合规代码。
• targetCompatibility：控制编译生成的字节码兼容的最低JVM版本（比如设为1.8，生成的.class文件能在Java 8及以上JVM上运行）。
  这个配置是团队协作和CI/CD的统一标准，保证所有人构建的产物完全一致。

2. IntelliJ IDEA项目结构的版本 #

这只是IDE本地的辅助配置，只影响本地开发体验，和最终构建结果无关：

• 用于IDE的语法高亮、代码提示、静态检查（比如把IDE项目SDK设为11，IDE会提示不能用Java 17的密封类，但如果Gradle的sourceCompatibility是17，执行gradle build依然能通过）。
• 控制IDE自带编译器的行为——只有当你不用Gradle、直接点IDE"编译"按钮时才生效，但正常Gradle项目都会用Gradle作为构建工具，这个场景几乎用不上。

联动与优先级 #

• 首次导入Gradle项目到IDEA时，IDE会自动读取Gradle java块的配置，同步到项目结构的SDK、语言级别设置，保证开发环境和构建规则一致。
• 若手动修改IDE项目结构版本但未改Gradle配置：
  • IDE会弹出提示，告知"Gradle配置与IDE配置不一致"，让你选择同步哪一边。
  • 实际执行gradle build时，完全无视IDE的本地修改，依然用Gradle里的版本编译。

一句话总结 #

Gradle的版本是管最终构建产物的，是项目必须遵守的统一规则；IDEA项目结构的版本是管本地写代码时IDE的提示和临时编译的，不影响正式构建结果。

内容的提问来源于stack exchange，提问作者automaton