从 Groovy 到 Kotlin DSL：我的迁移血泪史与实用技巧

去年接手一个老 Android 项目时，我差点被 Gradle 的 Groovy DSL 搞崩溃。
dependencies { implementation 'com.google.code.gson:gson:2.8.9' }——这行代码在 IDE 里居然能通过编译，但运行时却报 NoClassDefFoundError。
后来才明白，Groovy 的动态类型太“任性”，写错依赖名或版本号，Gradle 也装作没事人一样。
直到去年团队决定全面迁移到 Gradle Kotlin DSL，我才真正体会到：类型安全不是口号，是救命稻草。

为什么折腾 Kotlin DSL？——别骗自己了，它真香

IDE 友好度拉满：写 implementation("com.squareup.retrofit2:retrofit:2.9.0") 时，IntelliJ 直接给你提示依赖版本，而不是像 Groovy 那样“全靠猜”。
编译时检查：写错 implementation 成 implementaion？Kotlin 编译器直接报错，不用等到构建时才发现。
团队协作友好：新人写 dependencies 时，IDE 会提示 kotlin("jvm") 插件需要的正确写法，而不是“随便写个字符串”。

💡 真实案例：我们一个模块的依赖写成了 implementation("com.example:lib:1.0")，但实际仓库里只有 1.0.1。Groovy 版本能跑通，Kotlin DSL 一编译就报错——省了俩小时的线上排查。

从零开始：我的配置踩坑记录

1. 初始化项目（别被名字骗了）

别直接建 build.gradle.kts，先删掉旧的 build.gradle。
Gradle 会自动检测到 Kotlin DSL，然后生成一个基础文件。
关键点：

// build.gradle.kts
plugins {
    id("com.android.application") version "8.1.0" apply false
    id("org.jetbrains.kotlin.android") version "1.8.20" apply false
}

⚠️ 血泪教训：apply false 别漏！否则插件会直接应用到根项目，多模块项目直接炸。

2. 依赖管理：括号和类型别乱来

Groovy 里 implementation 'com.google.guava:guava:31.1-android' 没括号，Kotlin DSL 必须加括号：

dependencies {
    implementation("com.google.guava:guava:31.1-android")
}

为什么？Kotlin 把 implementation 当成函数，必须传参数。
（别问，问就是 Kotlin 语法强制要求）

3. 多模块项目：别用 `include` 了

Groovy 里 include ':app', ':feature'，Kotlin DSL 直接在 settings.gradle.kts 里写：

include(":app", ":feature", ":core")

更爽的是：模块路径自动补全，include(":feature") 写错成 include(":featrue")，IDE 直接标红。

避坑指南：我栽过的坑

❌ 问题：`build.gradle.kts` 里写 `val version = "1.0"`，但 Gradle 用不了

原因：Gradle 的 DSL 不能直接用 Kotlin 的 val。
解法：用 extra 或直接写在 project 里：

val version = "1.0"

dependencies {
    implementation("com.example:lib:$version") // ✅
}

❌ 问题：插件版本写错，Gradle 报 `Could not resolve` 但不具体

原因：插件版本号没加引号，比如 id("com.android.application") version 8.1.0。
解法：必须加引号！version "8.1.0"。
（Groovy 里可以不加，Kotlin DSL 严格要求）

✅ 真实技巧：快速回退到 Groovy

如果迁移一半卡住，删掉 build.gradle.kts，Gradle 会自动用 build.gradle。
别慌：这是 Gradle 的设计，不是你的锅。

结尾：别等了，现在就试试

我团队从 Groovy 迁移到 Kotlin DSL 用了两周，现在写构建脚本像写 Kotlin 代码一样顺手。
最爽的不是 IDE 提示，是某天深夜，我改完依赖后，Gradle 一编译就报“版本冲突”，而不是等到 CI 跑到一半才发现。

最后一句真心话：Gradle Kotlin DSL 不是“新潮”，是让构建更可靠的工具。
别再被 Groovy 的“动态灵活”忽悠了——类型安全不是枷锁，是护城河。