3、Kotlin DSL：为什么选择Kotlin DSL、Kotlin基础语法、从Groovy迁移到Kotlin DSL

说实话，我第一次接触 Gradle 的 Kotlin DSL 时，内心是抗拒的。Groovy 写得好好的，干嘛要折腾？但当我真正用了一个月后，嗯，真香。今天我就把这段心路历程，连同技术干货，一起分享给你。

3.1 为什么选择 Kotlin DSL？

先说说 Groovy 的问题。Groovy 本身是门动态语言，灵活是灵活，但坑也不少。我在项目中遇到过好几次，因为 Groovy 的隐式类型转换，导致构建脚本在本地跑得好好的，上了 CI 就报错。排查起来特别痛苦。

Kotlin DSL 解决了这些问题：

• 类型安全：Kotlin 是静态类型语言。你在写 dependencies 时，如果写错了方法名，IDE 直接标红。不用等到运行时才发现。
• IDE 智能提示：因为类型信息完整，IDE 可以给你补全。我习惯用 IntelliJ，写 Kotlin DSL 时，点一下就能看到所有可用的配置项。
• 更好的可读性：Kotlin 的语法更接近自然语言。你想想看，同样是配置依赖，Kotlin 的写法一眼就能看懂。
• 与 Android/Kotlin 项目无缝集成：如果你的项目本身就是 Kotlin 写的，那构建脚本也用 Kotlin，技术栈统一，维护成本更低。

3.2 Kotlin 基础语法（够用就行）

你不需要成为 Kotlin 专家，只需要掌握构建脚本中常用的那部分语法。说白了，就是变量、函数、Lambda 和扩展函数。

3.2.1 变量声明

// val 是只读变量（类似 final）
val projectName = "my-app"

// var 是可变量
var versionCode = 1

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

在 Gradle 脚本里，我几乎只用 val。因为构建配置一旦定义，就不该被修改。用 val 能避免意外赋值。

3.2.2 函数与 Lambda

// 普通函数
fun getVersionName(): String {
    return "1.0.0"
}

// Lambda 表达式
val printVersion = { version: String ->
    println("Version: $version")
}

// 调用
printVersion(getVersionName())

Lambda 在 Gradle 脚本里无处不在。比如配置依赖时，你其实就是在传 Lambda。

3.2.3 扩展函数（重点）

这是 Kotlin 最强大的特性之一。你可以给已有的类添加新方法，而不需要继承它。

// 给 String 类添加一个扩展函数
fun String.isValidModuleName(): Boolean {
    return this.startsWith("module-")
}

// 使用
val name = "module-core"
println(name.isValidModuleName()) // true

Gradle 的 Kotlin DSL 大量使用了扩展函数。比如 dependencies { } 这个块，其实就是给 Project 类添加了一个 dependencies 扩展函数。

3.2.4 字符串模板

val appName = "MyApp"
val version = "2.0"

// 直接用 $ 引用变量
println("App: $appName, Version: $version")

// 复杂表达式用 ${}
println("App: ${appName.uppercase()}")

这个在配置版本号、输出日志时特别方便。比 Groovy 的字符串拼接干净多了。

3.3 从 Groovy 迁移到 Kotlin DSL

迁移其实没那么可怕。我去年把一个中型项目从 Groovy 迁移到了 Kotlin DSL，前后花了两天时间。核心思路是：逐文件替换，边改边测。

3.3.1 文件命名变化

Groovy	Kotlin DSL
build.gradle	build.gradle.kts
settings.gradle	settings.gradle.kts
gradle.properties	gradle.properties（不变）

嗯，这里要注意：gradle.properties 文件不需要改，它还是用 properties 格式。

3.3.2 常见语法对照

场景	Groovy	Kotlin DSL
依赖声明	implementation 'com.example:lib:1.0'	implementation("com.example:lib:1.0")
插件声明	apply plugin: 'java'	plugins { java }
自定义任务	task hello { doLast { ... } }	tasks.register("hello") { doLast { ... } }
属性赋值	compileSdkVersion 34	compileSdk = 34

3.3.3 迁移步骤（我自己的做法）

1. 先改 settings.gradle.kts：这个文件最简单，通常只有仓库和项目名。
2. 再改根项目的 build.gradle.kts：配置插件、全局属性。
3. 最后改子模块：从依赖最少的模块开始，逐个迁移。
4. 每次改完都跑一次构建：确保没有编译错误。

3.3.4 常见迁移陷阱

• Groovy 的 def 关键字：在 Kotlin 里要换成 val 或 var。
• Groovy 的闭包参数：Kotlin 里要用 Lambda，注意括号和花括号的位置。
• Groovy 的隐式 it：Kotlin 里要显式声明参数名，或者用 it（但建议显式声明）。
• 字符串引号：Groovy 支持单引号和双引号，Kotlin 只支持双引号。

3.4 知识体系总览

下面这张图，是我对本章内容的总结。你可以把它当作一个快速参考。

好了，关于 Kotlin DSL 的核心内容就这些。说白了，它不是什么黑魔法，就是一套更安全、更现代化的构建脚本写法。你只要掌握了变量、Lambda 和扩展函数这三个概念，剩下的就是查表对照了。

我个人觉得，Kotlin DSL 最大的价值不是语法多漂亮，而是它让构建脚本变得可维护了。你想想看，一个项目维护两三年，构建脚本的复杂度会越来越高。用 Kotlin DSL，至少 IDE 能帮你检查错误，这比 Groovy 的“运行时才报错”强太多了。

如果你正在犹豫要不要迁移，我的建议是：新项目直接上 Kotlin DSL，老项目按模块逐步迁移。别想着一步到位，稳扎稳打才是正道。