如何在拆分大型Kotlin Gradle构建文件时正常使用脚本变量

核心结论澄清 #

通过apply(from = ...)加载的脚本完全支持定义变量和常量，你遇到的编译失败不是Gradle刻意设置的能力限制，而是旧版本Kotlin DSL的解析缺陷叠加语法位置错误共同导致的。
你触发报错的直接原因，是把val failedTests变量声明直接写在了tasks.test { }任务配置闭包内部：Gradle 6.8版本的Kotlin DSL编译器在处理被apply引入的外部脚本时，对闭包内部嵌入的局部变量声明存在语法识别bug，会误将val关键字判定为非法语法，最终抛出“expecting '}'”的无意义报错。

快速修复示例 #

如果需要在任务配置逻辑中使用自定义变量，只需要把变量声明移到脚本的顶层作用域，不要嵌入到任务、依赖等配置闭包内部即可，修改后的build.gradle.test.kts可以正常运行：

println("Applying")

// 变量定义放在脚本顶层作用域，不嵌套在闭包内
val failedTests = mutableListOf<TestDescriptor>()

tasks.test {
    // 闭包内只写逻辑引用，不做变量声明
    maxHeapSize = "2G"
    doFirst {
        println("已加载的失败用例缓存数量: ${failedTests.size}")
    }
}

println("Applied")

更适合大体积构建脚本的拆分方案 #

长期维护场景下，单纯靠apply(from)拆分脚本会丢失Kotlin DSL的类型安全、IDE自动补全能力，还会反复碰到各类解析兼容问题，推荐两种更可靠的拆分方式：

• 预编译脚本插件：把拆分的配置逻辑放到buildSrc/src/main/kotlin目录下的独立.kts文件中，在主构建脚本里通过插件ID引用，全程保留Kotlin类型校验和IDE代码提示，完全规避apply脚本的解析兼容问题。
• 扩展属性跨脚本传递：如果确实需要保留apply方式做轻量拆分，跨脚本共享的变量不要用普通局部变量，绑定到项目的extra扩展属性上，例如extra["testFailedCaseCache"] = mutableListOf<TestDescriptor>()，避免不同脚本之间的隐式作用域耦合。

常见踩坑提示 #

• 所有构建配置阶段的临时变量，都应该放在脚本顶层的配置作用域声明，不要嵌套在任务、仓库、依赖等配置闭包内部，这本身也符合Gradle的构建生命周期规则。
• 升级到Gradle 7.0以上版本后，apply脚本的闭包内变量声明解析bug会被修复，但依然建议优先使用预编译插件方式做拆分，长期可维护性远高于散列的apply脚本。

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