sourcecompatibility和targetcompatibility是gradle中控制java编译行为的硬性约束参数，分别对应javac的-source和-target选项：前者限定源码可使用的语言特性（如var、record），后者决定生成字节码的jvm兼容版本（如target=17则需jre17+运行）。
sourceCompatibility 和 targetCompatibility 是什么
这两个配置项直接对应 javac 的 -source 和 -target 参数，不是“建议”，而是编译器执行时的硬性约束。sourceCompatibility 控制你能写什么语法（比如 var、record、模式匹配），targetCompatibility 控制生成的 .class 文件能被哪个 JVM 加载运行（比如 Java 17 的字节码在 JRE 11 上会报 UnsupportedClassVersionError）。
Gradle 7.0+ 推荐用 java { version = ... } 写法
新项目或升级到 Gradle 7.0 及以上时，应优先使用 java { version = JavaVersion.VERSION_17 }。它比传统写法更安全，因为 Gradle 会自动匹配兼容的 JDK 工具链（前提是本地有对应版本 JDK 或启用了自动下载）。
-
sourceCompatibility和targetCompatibility被隐式设为一致值，避免手动不同步 - 若未设置
org.gradle.java.home，Gradle 会尝试从系统 PATH 或已安装 JDK 中探测，但不保证成功 - 多模块项目中，在根
build.gradle的subprojects块里统一配置即可，子模块无需重复声明
旧版 Gradle（
Gradle 6.x 或更早版本不识别 java { version = ... }，只能靠字符串或枚举值硬编码：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 写法一（推荐用枚举，类型安全）：
sourceCompatibility = JavaVersion.VERSION_17，targetCompatibility = JavaVersion.VERSION_17 - 写法二（字符串，易拼错）：
sourceCompatibility = '17'，targetCompatibility = '17' - 如果项目用了 Spring Boot，且父 POM 是
spring-boot-starter-parent:3.0.0+，则 Maven 侧由<java.version>17</java.version>控制，但 Gradle 不读这个，仍需在build.gradle单独配
常见错误：编译通过但运行时报错 UnsupportedClassVersionError
这说明 targetCompatibility 设高了，而目标环境 JVM 版本更低。比如设了 targetCompatibility = '21'，却部署到只装了 JRE 17 的服务器上。
- 检查方式：用
javap -verbose YourClass.class | grep major查看 class 文件主版本号（Java 17 → 61，Java 21 → 65） - CI 环境最容易出问题：脚本里没指定
org.gradle.java.home，导致./gradlew compileJava静默用了系统默认 JDK（常是旧版本） - IDE（如 IntelliJ）可能同时加载 Gradle 配置和本地 JDK 设置，右键项目 → “Reload project” 后务必确认显示的 Language Level 和 Project SDK 一致
真正关键的不是“怎么写那两行”，而是确保 sourceCompatibility、targetCompatibility、实际运行 JDK、CI 所用 JDK、IDE 配置这五者全部对齐——少一个，就埋一个半夜上线失败的雷。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
