Android Studio启用Gradle缓存的潜在问题及默认未启用原因

我有一个Android Studio项目，执行clean任务后构建需要20-40秒，耗时取决于CPU温度、NTFS文件系统缓存状态等因素。某次构建结果如下：

BUILD SUCCESSFUL in 23s
38 actionable tasks: 38 executed

有时我使用笔记本电池模式，性能受限，希望节省时间和电量。于是我寻找Gradle构建提速方案，找到如下配置：

org.gradle.caching=true # added to gradle.build file

启用Gradle缓存后，构建速度大幅提升：

BUILD SUCCESSFUL in 4s
38 actionable tasks: 14 executed, 24 from cache

日常开发调试中，性能提升虽不如此显著，但仍可感知。现咨询：启用该缓存可能会出现哪些问题？为何它默认未启用？

启用Gradle缓存可能出现的问题 #

• 缓存一致性异常：如果任务的输入输出依赖没被Gradle正确识别（比如自定义任务漏标记隐性依赖），会导致旧缓存产物被错误复用，出现代码修改后构建输出仍为旧版本的情况。
• 磁盘空间占用过高：缓存会长期存储各任务的构建产物，多模块、高频迭代的项目会快速积累大量缓存文件，占用较多磁盘空间。
• 构建问题排查难度提升：出现构建异常时，无法直接判断是代码问题还是缓存复用导致的，需要额外执行清理缓存后重构建的验证步骤，增加调试成本。
• 跨环境缓存兼容性差：不同操作系统、JDK版本或Gradle版本之间共享缓存时，可能出现缓存无法复用或复用后报错的情况，因为环境差异可能被缓存逻辑忽略。

为什么Gradle缓存默认未启用 #

• 降低新手入门门槛：不熟悉Gradle构建逻辑的开发者容易因缓存一致性问题遇到难以排查的错误，默认关闭可减少这类困惑。
• 保证项目兼容性：部分老旧插件或自定义任务未正确实现输入输出标记，启用缓存会直接引发构建失败，默认关闭能适配更多存量项目。
• 平衡初始构建开销：首次构建时生成缓存会增加磁盘IO开销，对于简单项目，这个额外成本可能抵消后续的缓存收益，默认关闭更适合通用场景。
• 兼容历史构建习惯：构建缓存是Gradle后续版本新增的功能，默认关闭可避免对已有项目的构建流程造成意外影响，保持向下兼容。

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