什么是 Gradle 任务缓存？如何配置本地和远程缓存？

返回 构建与质量门禁 目录

标准回答

构建缓存复用相同输入产生的任务输出，用 org.gradle.caching=true 或 --build-cache 启用；在 settings.gradle 的 buildCache 中配置 local 和 remote。远程缓存的地址、凭证、读写权限需明确，通常由受控构建推送；任务须具备正确输入输出和可缓存条件。

通俗例子

两个开发者编译同一份未变化的模块，可从远程缓存复用产物；任务若漏报输入，复用出来的结果反而可能错误。

深入解释

**缓存复用什么：**任务输入及实现满足缓存条件时，可以复用之前产生的输出，省去重新计算。缓存不是简单跳过所有看起来耗时的任务。

**缓存为什么会出错：**任务偷偷读取未声明的配置或环境，Gradle 就可能无法判断输入变化。应准确声明输入输出，并避免把密钥等敏感内容混入可共享的缓存产物。

内容来源

• Android · AI Agent 知识手册 · 原条目 9.5.2