Android Studio生成大量Gradle缓存及超100MB wrapper文件无法推GitHub如何解决
2026-9-24
解决方案
核心逻辑是将Gradle生成的非项目必要文件移出Git追踪范围，同时调整Gradle配置避免缓存文件生成到项目目录内，具体操作步骤如下：
1. 配置项目.gitignore规则
在项目根目录找到.gitignore文件，不存在则新建，追加以下规则：
# Gradle项目级缓存 /gradle/caches/ # Gradle Wrapper下载的安装包文件 /gradle/wrapper/dists/ # 其他Gradle临时生成文件 *.gradle /build/
上述规则会让Git自动忽略对应路径下的所有文件，不会再将这些文件纳入变更统计。
2. 清理已被Git追踪的无关文件
由于对应路径的文件此前已经被Git纳入追踪，需要执行命令将其从Git索引中移除，该操作不会删除本地的实际文件，不会触发Gradle重新下载：
打开终端进入项目根目录，依次执行以下命令：
- 移除缓存目录的Git追踪：
git rm -r --cached gradle/caches - 移除Gradle安装包目录的Git追踪：
git rm -r --cached gradle/wrapper/dists - 提交本次变更：
git commit -m "chore: 忽略Gradle缓存及安装包文件"
3. 调整Gradle全局缓存配置（可选，彻底避免同类问题）
当前项目内出现gradle/caches目录，说明Android Studio将Gradle缓存路径配置到了项目目录内，可修改为全局缓存路径，后续所有项目的Gradle缓存都会生成到系统用户目录，不会混入项目文件：
- 打开Android Studio，进入
Preferences > Build, Execution, Deployment > Build Tools > Gradle - 找到
Gradle user home配置项，填写值为~/.gradle - 点击Apply保存后重启Android Studio即可生效
验证
操作完成后刷新Git变更列表，不会再出现数千个缓存文件和超大Gradle安装包，可正常推送代码到GitHub，重启Android Studio也不会触发重复下载。
内容的提问来源于stack exchange，提问作者nextedoff
相关产品推荐
相关产品推荐
