Gradle如何修改主目录清理策略 避免依赖缓存频繁被清理

Gradle 默认开启未使用依赖缓存的自动清理机制，默认保留未被使用的依赖时长为30天，和你遇到的每月数次丢失缓存的情况吻合，可以通过修改参数延长缓存保留时长，具体方法如下：

配置参数说明 #

你只需要修改以下两个核心参数即可调整清理频率：

• org.gradle.dependency.cache.retention.days：依赖缓存的最短保留天数，默认值为30，可根据需求调整为90、180甚至365
• org.gradle.build.cache.expireAfter：构建缓存的最短保留时长，默认值为7d，可同步调整为对应时长，单位支持d（天）、h（小时）

两种配置生效方式 #

全局生效（推荐，适配多项目场景） #

1. 打开Gradle全局配置目录：
   • Linux/macOS 路径：~/.gradle
   • Windows 路径：C:\Users\<你的用户名>\.gradle
2. 找到目录下的gradle.properties文件，不存在就新建一个
3. 将上述参数写入文件，示例配置如下：

org.gradle.dependency.cache.retention.days=180
org.gradle.build.cache.expireAfter=180d
org.gradle.cache.reserved.memory=4096m

最后一项为缓存预留空间参数，默认值为1024m，本地依赖总量大的情况下调大该值可以进一步避免缓存被主动清理。

单项目生效 #

如果仅需要给特定项目调整规则，直接把上述参数写入对应项目根目录的gradle.properties文件即可。

额外注意事项 #

• 确认IntelliJ IDEA的Gradle配置使用全局缓存目录：打开IDEA设置 → 构建、执行、部署 → Gradle，检查「Gradle用户主目录」路径是否和上面的全局Gradle配置目录一致，不要设置为项目内路径
• 不要随意点击IDEA Gradle面板里的「重新加载所有项目并清除缓存」按钮，避免误触发缓存清理

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