配置Java版本需设置sourceCompatibility和targetCompatibility为11，并推荐使用Java Toolchain指定languageVersion=JavaLanguageVersion.of(11)；通过compileJava中options配置编码UTF-8、启用-Xlint:deprecation和-unchecked警告、开启调试信息；启用增量编译，结合gradle.properties中org.gradle.parallel=true与org.gradle.caching=true提升构建性能；依赖管理使用implementation、compileOnly和annotationProcessor确保编译一致性。
在Java Gradle项目中合理配置编译选项，不仅能提升构建效率，还能增强代码质量与跨平台兼容性。关键在于正确设置编译器参数、JVM版本目标以及启用必要的警告检查。
配置Java版本与编译兼容性
确保项目在指定的Java版本下编译和运行，需在build.gradle中明确sourceCompatibility和targetCompatibility：
- sourceCompatibility = "11" 表示源码使用Java 11语法
- targetCompatibility = "11" 指定生成的字节码适配Java 11 JVM
现代Gradle项目推荐使用Java Toolchain方式，实现跨开发环境的一致性：
java {
toolchain {
languageVersion = JavaLanguageVersion.of(11)
}
}
自定义编译器参数（javac options）
通过options块添加编译时参数，控制警告输出和调试信息：
立即学习“Java免费学习笔记（深入）”；
compileJava {
options.encoding = 'UTF-8'
options.compilerArgs += ['-Xlint:deprecation', '-Xlint:unchecked']
options.deprecation = true
options.debugOptions.on = true
}
- -Xlint:deprecation 启用过时API警告
- -Xlint:unchecked 检查泛型未受检转换
- encoding = 'UTF-8' 避免中文注释乱码问题
启用增量编译与并行构建
提升大型项目构建速度的关键配置：
- Gradle默认开启增量编译（incremental compilation），仅重新编译变更类
- 在gradle.properties中启用并行执行：
org.gradle.parallel=true org.gradle.workers.max=4
- 同时建议开启构建缓存：org.gradle.caching=true
统一管理依赖与编译一致性
使用dependencies块精确控制编译期依赖，并避免版本冲突：
dependencies {
implementation 'org.apache.commons:commons-lang3:3.12.0'
compileOnly 'org.projectlombok:lombok:1.18.30'
annotationProcessor 'org.projectlombok:lombok:1.18.30'
}
- compileOnly 用于不打包进最终jar的注解处理器依赖
- annotationProcessor 显式声明注解处理路径
