Gradle中Kotlin项目指定JDK版本的多种方式及差异解析

下面逐个拆解这三种配置的核心区别和适用场景：

1. Kotlin多平台专属的JVM工具链配置 #

const val JDK_VERSION = 17

extensions.configure<KotlinMultiplatformExtension> {
    jvm {
        jvmToolchain(JDK_VERSION)
    }
}

• 差异点：这是专门给Kotlin多平台项目设计的配置，它管控整个JVM相关构建环节的JDK环境——从Kotlin编译、Java编译到测试、打包，全流程都会用指定版本的JDK。而且Gradle的Toolchain机制会自动帮你下载或匹配对应版本的JDK，不用手动折腾本地环境变量。
• 适用场景：
  • 开发Kotlin多平台项目（同时包含JVM、Android、iOS等目标）
  • 想统一所有JVM相关任务的JDK版本，避免本地环境不一致导致的构建报错
  • 希望Gradle自动管理JDK版本，不用自己手动安装对应JDK

2. 仅针对Kotlin编译任务的字节码目标配置 #

tasks.withType(KotlinCompile::class.java) {
    compilerOptions {
        jvmTarget.set(JvmTarget.fromTarget(JDK_VERSION.toString()))
    }
}

• 差异点：这个配置只作用于Kotlin编译任务，管控Kotlin代码编译后生成的字节码能兼容的最低JVM版本，不会影响其他任务（比如Java编译、测试运行时用的JDK）。简单说就是，它控制的是输出的字节码版本，而非构建时用的JDK本身。
• 适用场景：
  • 只需要调整Kotlin代码的字节码兼容性，不想改变整个构建环境的JDK
  • 项目里部分模块需要兼容更低版本的JVM，单独给这些模块的Kotlin编译任务做配置
  • 非多平台的Kotlin JVM项目，仅需控制Kotlin编译输出的字节码版本

3. Java项目标准的兼容性配置 #

extensions.findByType(JavaPluginExtension::class.java)?.apply {
    sourceCompatibility = JavaVersion.toVersion(JDK_VERSION)
    targetCompatibility = JavaVersion.toVersion(JDK_VERSION)
}

• 差异点：这是Java项目的标准配置，管控Java代码的源语法版本（允许用哪些Java语法）和字节码目标版本。如果你的项目是Kotlin+Java混编，Kotlin编译默认会对齐这个配置，但可以被上面的方式2覆盖。如果项目里没有Java代码，单独用这个配置对Kotlin编译没有直接作用。
• 适用场景：
  • Kotlin与Java混编的项目，需要统一Java代码的兼容性规则
  • 基于Gradle Java插件的项目，希望让Java和Kotlin的兼容性配置保持一致（Kotlin可单独调整）
  • 需要确保项目生成的字节码能在指定版本的JVM上运行

简单总结 #

• 多平台项目优先选方式1，能统一整个JVM构建环境
• 纯Kotlin JVM项目，只需要控制字节码版本就用方式2；混编项目可以配合方式3一起用
• 方式3主要服务于Java代码，没Java代码的话单独用它意义不大

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