Gradle是通用构建工具,Java版本需通过启用java插件并设置sourceCompatibility与targetCompatibility指定;编译不依赖JAVA_HOME,而是由Gradle自行管理JDK;implementation与compileOnly分别控制依赖的传递性与编译期可见性。
Gradle 不是 Java 的构建工具,而是通用构建工具;它用 Groovy 或 Kotlin DSL 写配置,不是 Java 代码本身
build.gradle 里怎么指定 Java 版本?
Java 版本由 java 插件控制,不是靠 sourceCompatibility 单独生效——必须先应用插件。常见错误是只设了兼容性却没启用插件,导致编译仍用默认 JDK。
- 用
plugins { id 'java' }启用标准 Java 插件(推荐方式) - 再设置
java.sourceCompatibility = JavaVersion.VERSION_17和java.targetCompatibility = JavaVersion.VERSION_17 - 如果项目用 JDK 21 编译但要跑在 JDK 17 上,
targetCompatibility必须显式设为VERSION_17,否则生成的字节码可能含不兼容指令 - Gradle 8.4+ 默认使用
--release编译参数,所以sourceCompatibility还会影响可调用的 API 范围
为什么 compileJava 任务不读 JAVA_HOME?
Gradle 默认用自己下载的 JDK(通过 gradle.properties 中的 org.gradle.java.home 或 wrapper 自动管理),而不是系统 JAVA_HOME。这常导致本地编译结果和 CI 不一致。
- 检查当前用的 JDK:运行
./gradlew --version看 “JVM:” 行 - 强制指定 JDK 路径:在项目根目录
gradle.properties加org.gradle.java.home=/path/to/jdk-17 - 若用 JDK 21 的新特性(如虚拟线程),还需在
compileJava里加 JVM 参数:options.fork = true; options.forkOptions.jvmArgs = ['--enable-preview']
dependencies 块里 implementation 和 compileOnly 有什么区别?
这是类路径隔离的核心机制,直接影响打包大小、运行时类冲突和 IDE 导入行为。