gradle中需显式配置java编译版本和源文件编码：在java{}块中设sourcecompatibility/targetcompatibility为javaversion.version_17，并设options.encoding="utf-8"，同时确认org.gradle.java.home指向jdk 17。
Gradle 中配置源文件编码和 Java 编译版本，核心是控制 compileJava 任务的行为。这两项设置直接影响编译是否成功、中文是否乱码、以及能否使用新语法（比如 switch 表达式、record、模式匹配等）。不配或配错，轻则警告，重则编译失败或运行时异常。
指定 Java 源码与字节码版本
必须显式声明，Gradle 不会自动根据你本地 JDK 版本推断。推荐用类型安全写法（Gradle 7.0+）：
-
Gradle 7.0 及以上：在
build.gradle的java { }块中设置
java {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
}
- 旧版 Gradle（如 6.x）：直接设字符串
sourceCompatibility = '17' targetCompatibility = '17'
- 若项目含 Spring Boot，且用了
spring-boot-starter-parent，优先通过<java.version>17</java.version>统一控制，避免与 Gradle 配置冲突 - 务必检查
gradle.properties中org.gradle.java.home是否指向正确的 JDK 17 路径，否则./gradlew compileJava可能静默降级使用旧 JDK
统一设置源文件编码为 UTF-8
避免中文注释、字符串出现乱码，尤其跨平台协作时。推荐在 build.gradle 顶层配置，作用于所有 Java 编译任务：
OpenJDK 24 Windows x64
下载
OpenJDK 24 Windows x64 官方参考实现（24+36），适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。
- 方式一（推荐，简洁）：在
java { }块内加一行
java {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
options.encoding = "UTF-8"
}
- 方式二（兼容旧版）：对
compileJava任务单独配置
compileJava {
options.encoding = "UTF-8"
}
- 如果项目还混用 Groovy 或 Kotlin，建议在对应插件块（如
groovy { }）里也设options.encoding，保持一致性
附加：启用编译警告与调试信息
提升代码质量，方便排查问题：
- 开启详细警告（如未使用泛型、资源未关闭）
compileJava {
options.encoding = "UTF-8"
options.compilerArgs += ["-Xlint:all", "-Xlint:-options"]
}
- 生成完整调试信息（行号、局部变量），便于 IDE 断点调试
compileJava {
options.debug = true
options.debugOptions.debugLevel = "source,lines,vars"
}
- 注意：
-Xlint:-options是为了屏蔽“未指定 -source”这类无关警告，让真正的问题更突出
验证配置是否生效
别只看配置文件，实际执行时才见真章：
- 运行
./gradlew compileJava --info，查看日志中是否打印出source compatibility: 17和encoding: UTF-8 - 用
javap -verbose查看生成的 class 文件，确认major version匹配 JDK 17（对应值为 61） - 故意写一个 Java 17 特有语法（如
switch (x) -> { ... }），看是否编译通过
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
