3、Kotlin DSL入门：为什么选择Kotlin DSL、Kotlin基础回顾、Gradle Kotlin DSL配置示例

好，我们直接进入正题。这一章聊 Kotlin DSL，说白了就是 Gradle 构建脚本的另一种写法。你可能会问：Groovy 用得好好的，为什么要换？嗯，我当初也有这个疑问。直到我在一个大型多模块项目里被 Groovy 的动态类型坑了三次之后，才彻底倒向了 Kotlin DSL。

为什么选择 Kotlin DSL

先说说我的个人感受。Groovy 的构建脚本写起来确实快，但维护起来有时候像在猜谜。尤其是当你需要调试一个复杂的任务依赖时，IDE 几乎给不了任何提示。Kotlin DSL 就不一样了——它是静态类型的。

我举个例子。你在 build.gradle 里写了一个依赖：

// Groovy 写法
implementation 'com.google.guava:guava:30.1-jre'

如果版本号写错了，Groovy 不会报错，只有运行时才会炸。换成 Kotlin DSL：

// Kotlin DSL 写法
implementation("com.google.guava:guava:30.1-jre")

IDE 会直接帮你校验格式，甚至能自动补全版本号。我在项目中遇到过好几次因为 Groovy 字符串拼接导致的诡异 bug，换成 Kotlin DSL 之后，这类问题基本绝迹了。

另外，Kotlin DSL 的扩展函数和委托属性让配置变得更优雅。你想想看，一个 dependencies 块里，每个依赖都是一个函数调用，而不是字符串。这不仅仅是语法糖，这是可读性的质变。

Kotlin 基础回顾

别担心，你不需要成为 Kotlin 专家。Gradle Kotlin DSL 用到的 Kotlin 特性其实很有限。我帮你划重点，就这几个东西够用了。

变量与类型

Kotlin 是静态类型语言，但类型推断很智能。你不需要像 Java 那样写一堆类型声明。

// 类型推断
val projectName = "my-app"  // 自动推断为 String
var version = "1.0.0"       // 可变变量

// 显式声明
val compileSdk: Int = 34

这里要注意 val 和 var 的区别。val 是只读的，相当于 Java 的 final。var 是可变的。在 Gradle 脚本里，我建议尽量用 val，减少副作用。

函数与 Lambda

Gradle DSL 大量使用 Lambda 表达式。Kotlin 的 Lambda 语法非常简洁。

// 普通函数
fun printMessage(msg: String) {
    println(msg)
}

// Lambda 表达式
val greeting: (String) -> Unit = { name -> println("Hello, $name") }

// 如果 Lambda 是最后一个参数，可以提到括号外面
tasks.register("hello") {
    doLast {
        println("Hello from Kotlin DSL")
    }
}

看到 tasks.register("hello") { ... } 这种写法了吗？这就是 Kotlin DSL 的精髓——尾 Lambda 语法。它让构建脚本看起来像是一种领域特定语言，而不是一堆方法调用。

扩展函数

这是 Kotlin 最强大的特性之一。Gradle 大量使用扩展函数来扩展已有的 API。

// 给 String 添加一个扩展函数
fun String.isValidVersion(): Boolean {
    return this.matches(Regex("\\d+\\.\\d+\\.\\d+"))
}

// 使用
val version = "1.0.0"
println(version.isValidVersion())  // true

在 Gradle 脚本里，dependencies、plugins 这些块本质上都是扩展函数。你不需要理解底层实现，只需要知道怎么用就行。

委托属性

这个稍微高级一点，但 Gradle 里用得很频繁。比如 by lazy 延迟初始化：

val myConfig: String by lazy {
    // 只在第一次访问时计算
    readConfigFile()
}

在 Gradle 脚本里，tasks、configurations 这些对象都是通过委托属性实现的。你不需要手动创建它们，直接调用就行。

Gradle Kotlin DSL 配置示例

理论说完了，我们直接看代码。下面是一个完整的 build.gradle.kts 示例，涵盖了最常见的配置场景。

// build.gradle.kts
plugins {
    id("org.jetbrains.kotlin.jvm") version "1.9.0"
    id("application")
}

group = "com.example"
version = "1.0.0"

repositories {
    mavenCentral()
    maven {
        url = uri("https://jitpack.io")
    }
}

dependencies {
    implementation("org.jetbrains.kotlin:kotlin-stdlib")
    implementation("com.google.guava:guava:32.1.2-jre")
    testImplementation("org.junit.jupiter:junit-jupiter:5.10.0")
}

application {
    mainClass.set("com.example.MainKt")
}

tasks.test {
    useJUnitPlatform()
    testLogging {
        events("passed", "skipped", "failed")
    }
}

tasks.register("greet") {
    doLast {
        println("Hello from ${project.name} v${project.version}")
    }
}

这个脚本里包含了：

• 插件声明：使用 id() 函数，而不是 Groovy 的字符串
• 仓库配置：maven { url = uri(...) } 这种写法更清晰
• 依赖管理：每个依赖都是一个函数调用，支持自动补全
• 任务配置：tasks.register 和 doLast 都是类型安全的

多项目配置

如果你管理的是多模块项目，settings.gradle.kts 的写法是这样的：

// settings.gradle.kts
rootProject.name = "my-multi-module-project"

include(":core")
include(":web")
include(":api")

// 可以添加条件判断
if (System.getProperty("includeTests") != null) {
    include(":integration-tests")
}

注意 include 函数的参数是字符串，但 Kotlin 会帮你检查格式。如果你写 include(":core:")，IDE 会直接报错。

自定义任务

Kotlin DSL 里自定义任务也很直观：

abstract class MyTask : DefaultTask() {
    @get:Input
    abstract val message: Property<String>

    @TaskAction
    fun run() {
        println("Message: ${message.get()}")
    }
}

tasks.register<MyTask>("myTask") {
    message.set("Hello from custom task")
}

这里用了 abstract class 和 Property 类型，这是 Gradle 推荐的懒配置方式。我刚开始用的时候觉得有点绕，但习惯了之后发现它比 Groovy 的 @TaskAction 注解更灵活。

知识体系图

下面这张图帮你梳理了 Kotlin DSL 的核心知识结构。从基础语法到 Gradle 配置，再到高级特性，一目了然。

这张图把 Kotlin DSL 的三大块串起来了。左边是动机，中间是基础，右边是实战。你不需要一次性全部掌握，先从右边的配置示例入手，遇到不懂的再回头看中间的基础知识。

---

公众号:蓝海资料掘金营，微信deep3321