3. build.gradle(kts) 语法错误：常见括号、缩进与符号陷阱归纳总结

Kotlin DSL 的 Gradle 脚本，说白了就是 Kotlin 代码。但很多人把它当 Groovy 写，结果编译时爆出一堆红色波浪线。我刚开始切换到 KTS 那阵子，每天至少被括号气晕一次。其实只要搞清楚三个核心陷阱，90% 的错误都能提前规避。

3.1 括号匹配——最隐蔽的幽灵

Kotlin 里函数调用可以用花括号代替圆括号吗？可以，但也分场合。

• 普通函数调用：必须用圆括号，比如 implementation("com.android.support:appcompat:28.0.0")。写成 implementation "..." 在 Groovy 里合法，在 KTS 里直接报错。
• Lambda 参数：可以写在圆括号外面，dependencies { ... } 其实是 dependencies({ ... }) 的简写。这时花括号是 lambda 表达式，不是函数体。
• 多层嵌套：android { defaultConfig { ... } } 看起来整齐，但如果你漏了一个花括号，整个脚本就废了。

我在项目中养成了一个习惯：所有括号成对敲完再回车。比如先写 implementation("")，再把光标移回引号内输入依赖。这样括号永远不会少。

3.2 缩进误区——美观不等于正确

Kotlin 对缩进没有强制要求，但 Gradle 脚本里很多人以为缩进代表层级。其实括号才决定作用域。

// ❌ 看着像嵌套，实际是顺序执行
android {
compileSdk 34
defaultConfig {
applicationId "com.example"
}
}

// ✅ 正确写法
android {
    compileSdk = 34
    defaultConfig {
        applicationId = "com.example"
    }
}

左上角的截图你想想看：compileSdk 不赋值只写数字，在 Kotlin 里它会被当成布尔表达式，编译不报语法错但语义完全不对。缩进不对不会导致编译失败——但它会骗过你的眼睛。我遇到过有人把 defaultConfig 写到了 android 块的外面，因为缩进让他误以为还在块内。

3.3 符号陷阱——逗号、分号与引号

记得有一次，我把 minSdk = 21 写成了 minSdk 21，IDE 没报错，但 AGP 运行时直接炸了。为什么？因为 minSdk 21 被解析为 minSdk.plus(21)？不，Kotlin 把它当成了一个未使用的表达式，编译器只给了警告，但 AGP 读取不到赋值。

3.4 字符串模板与引用陷阱

Kotlin 支持字符串模板 $variable，但在 Gradle 脚本里这个挺容易出问题。

// 错误用法
versionName = "release_$versionCode"  // 如果 versionCode 是 Int，直接拼接不会自动转换

// 正确用法
versionName = "release_${versionCode}"

还有，当变量名后面紧跟字母时，不带花括号会吞掉后面的字符。比如 "build$type" 会被解析为 build$type 变量，而不是 build 拼接 type。

3.5 IDE 帮你抓狂——但你必须学会看错误

Android Studio 对 Kotlin DSL 的支持越来越好，但报错信息有时不如 Groovy 直观。比如“Unresolved reference: compileSdk”其实可能是因为你忘了 =。或者“Type mismatch”是因为你把字符串写成了字符。我总结了几个快速定位法：

• 双击错误行的红点，看看 IDE 给出的“预期类型”和“实际类型”。
• 如果报错在花括号上，基本是 lambda 参数类型不匹配或括号不对应。
• 如果报错在 implementation 上，查查逗号和引号。