Gradle 缓存太大了，怎么清理？

项目已经不做了，Gradle 下载的依赖和构建时生成的缓存，却可能还留在电脑上。用 Android Studio、IntelliJ IDEA 做过几个项目后，用户目录里的 .gradle 就值得检查一下。

Gradle 缓存可以清理，但别把整个 .gradle 文件夹直接删掉。 里面除了缓存，还有可能存着全局配置。清理后，后续构建可能需要重新下载依赖、重新生成文件；正在用的项目，尤其是离线项目，不必为了腾空间全部清空。

不想挨个找目录，可以先用 MangoDisk 看看 Gradle 和其他开发工具分别占了多少空间，再决定清哪一项。

用 MangoDisk 找出值得清理的缓存

打开 MangoDisk 的深度清理，扫描后在「开发工具」中查看「Gradle 构建缓存」。展开结果，就能核对占用大小和实际路径，不用先记住那些隐藏目录在哪里。

同一个页面也能比较 npm、pnpm、Cargo 等受支持的开发缓存。磁盘快满时，先处理占用大、清理后也能重新获取的内容，比把所有缓存一口气删掉更实用。

准备清理 Gradle 时：

1. 保存工作，结束构建和同步，退出 Android Studio、IntelliJ IDEA 等相关程序，并按提示关闭 Gradle、Java 进程。
2. 取消不准备清理的项目，只勾选已经检查过的 Gradle 缓存。
3. 核对所选路径和清理影响，再确认执行。扫描本身不会删除文件。

MangoDisk 清理的是选中范围内的缓存，不会替你判断哪些依赖以后还会用到。删除不经过回收站；需要保留的离线依赖或无法重新获取的文件，先备份。 恢复限制见安全清理指南。

Windows 上的 Gradle 清理范围包括 caches、daemon、workers 和 notifications；macOS 还包括下载的 Gradle Wrapper 发行包和 .tmp 临时目录。项目源码、全局 gradle.properties、init.d 脚本和 JDK 不在这条缓存规则的清理范围内。

手动清理时，别删错文件夹

Gradle 默认把用户级数据放在这些位置：

如果配置过 GRADLE_USER_HOME，以实际设置的目录为准。MangoDisk 的标准 Gradle 规则检查默认位置，不保证覆盖你另外指定的目录。Gradle 官方目录说明也区分了缓存、配置和下载的工具。

手动处理同样要先关闭相关程序。打开目录后，先查看 caches 的大小和内容，确认要清理，再删除目标文件夹；不要连同外层 .gradle 一起删除。gradle.properties 可能保存了代理或仓库设置，init.d 可能有团队使用的脚本，jdks 则是构建要用的 Java 环境。

项目里的 gradle 文件夹也不是用户目录里的 .gradle 缓存。它通常存放 Wrapper 文件，和项目根目录中的 gradlew、gradlew.bat 一样，应当保留。

为什么运行 clean，空间还是没腾出来

gradlew clean 通常清理的是当前项目的 build 输出，不是用户目录下的全局依赖缓存。所以，项目清理成功了，.gradle/caches 仍然很大，并不矛盾。自定义项目的 clean 任务可能有额外操作，执行前仍要确认任务定义。具体行为可查 Gradle 的 clean 说明。

如果是旧项目里的构建文件占了空间，MangoDisk 的「项目构建产物」可以识别受支持 Gradle 项目中的 build 和项目级 .gradle，让你按项目核对后清理。这与「Gradle 构建缓存」是两类结果，不是删除项目本身。 如果曾把需要留存的安装包或报告放进这些输出目录，先复制出来。

--refresh-dependencies 也不是释放空间的命令。它用于重新检查依赖，已有文件有效时仍可能复用，不会把整个缓存库清空。Gradle 官方依赖缓存说明

清理前，留意下一次构建

删除缓存后，下一次构建可能更慢，也可能需要联网下载。准备离线工作，或项目依赖已经无法从公司仓库、旧仓库获取时，先保留相应缓存。

Gradle 本身有自动清理机制，不需要每次构建后都清一遍。手动整理更适合磁盘空间紧张、长期不用某些项目，或确认某批缓存已经不需要的情况。

如果 Gradle 清完了，空间仍然不够，可以用 MangoDisk 的磁盘空间分析查看整块盘或项目所在目录。顺着占用较大的方块逐层打开，看看是不是旧项目、安装包或其他工具的数据还在占空间。

下载 MangoDisk，把分散的开发缓存和构建产物集中检查，再决定哪些值得清理。支持 Windows 和 macOS，免费开源，无需注册或登录。

相关阅读：pnpm 缓存清理 · Cargo 缓存与 target 文件夹 · 开发者磁盘清理指南