如何创建仅本地生效、被版本控制系统忽略的Gradle任务

你现有方案的核心问题是 强制apply不存在的文件会直接触发Gradle配置阶段报错，只需要加一层文件存在判断即可完美适配本地+CI双环境，不需要改动你已经习惯的local.gradle使用逻辑。

方案1：最小改动适配原有写法 #

直接修改build.gradle里的apply逻辑，仅当本地配置文件真实存在时才加载，CI环境无该文件时自动跳过，不会抛出异常：

// 替换原来的 apply from: 'local.gradle' 语句
def localConfig = file("local.gradle")
if (localConfig.exists()) {
    apply from: localConfig
}

该方案完全兼容你之前的使用习惯：

• 本地开发时，你依然可以在local.gradle中编写专属调试任务、本地测试用的构建参数，和之前用法完全一致
• 保持local.gradle加入.gitignore的配置，该文件不会被提交到版本仓库
• CI环境拉取的代码中不存在local.gradle，判断逻辑会直接跳过加载步骤，不会触发构建失败

配套优化建议 #

• 可以在仓库中提交一个local.gradle.example模板文件，写入本地自定义任务的示例写法、可配置参数说明，团队新成员拉取代码后只需要复制该文件重命名为local.gradle，即可按需修改自己的本地配置，模板文件提交到仓库不会影响正常构建
• 注意：local.gradle中仅允许存放本地调试专属的临时逻辑，所有正式构建、打包必须的任务和配置，必须写在提交到仓库的正式Gradle脚本中，避免出现本地能跑、CI/其他同事拉代码构建失败的问题

方案2：适配Kotlin DSL写法 #

如果你项目用的是build.gradle.kts格式的Kotlin版Gradle脚本，判断逻辑写法如下：

val localConfig = file("local.gradle.kts")
if (localConfig.exists()) {
    apply(from = localConfig)
}

其余规则和Groovy写法完全一致。

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