Windows C盘清理—— Android Studio .gradle 文件夹迁移

Windows C盘清理—— Android Studio .gradle 文件夹迁移

一、问题背景

在 Android Studio 开发过程中，Gradle 负责管理三方库、远程库的依赖，会自动下载 Maven 仓库中的 aar 或 jar 文件，并缓存到本地磁盘。随着开发项目的累积，Gradle 缓存的依赖库会持续增多，形成庞大的缓存文件夹，导致 C 盘空间逐渐被占用，甚至出现系统空间不足的报警提示。

关键信息

• 默认缓存路径：C:\Users\你的用户名\.gradle（例如C:\Users\Administrator\.gradle）

• 缓存体积示例：半年内可累积至 5G 左右（实测数据：492 GB 实际大小，5.03 GB 占用空间）

• 文件夹规模：包含 66334个文件、28293 个文件夹

二、迁移步骤

通过 Android Studio 自带设置修改.gradle文件夹存储路径，具体操作如下：

1. 打开设置界面

• 方式一：点击 Android Studio 顶部菜单栏File→Settings...（快捷键：Ctrl+Alt+S）
• 方式二：直接使用快捷键Ctrl+Alt+S快速调出设置窗口

2. 定位 Gradle 配置项

在设置窗口左侧导航栏中，依次展开：

Build, Execution, Deployment→Build Tools→Gradle

3. 修改缓存路径

在右侧找到Gradle user home选项，将默认路径（C:\Users\你的用户名\.gradle）改为其他盘符的指定目录（例如H:\Android\.gradle），点击Ok保存设置。

4. 迁移原有缓存文件

1. 关闭 Android Studio（避免文件被进程锁定，导致拷贝失败）；

2. 找到原缓存目录（C:\Users\你的用户名.gradle），将整个.gradle文件夹复制到新设置的目录下（例如D:\Android.gradle）；

3. 重新打开 Android Studio，项目会自动刷新依赖路径，因已拷贝原有缓存，无需重新下载依赖库。

5. 清理原路径文件

确认新路径下的 Gradle 缓存正常工作后，可删除原 C 盘路径（C:\Users\你的用户名\.gradle）下的文件夹，释放 C 盘空间。

三、扩展：清理 Gradle 缓存

若需清理老项目的无用缓存（目前无指定项目缓存清理功能，仅支持全量清理），操作如下：

1. 点击 Android Studio 顶部菜单栏File→Invalidate Caches / Restart...；
   

2. 在弹出的窗口中，选择清理的内容，然后点击Invalidate and Restart（清理缓存并重启）；

3. 重启后，Android Studio 会重建缓存，各项目需重新下载依赖库（仅保留当前项目必要缓存，节省空间）。

效果

清理后可释放 C 盘 5G 以上空间（根据缓存累积量有所差异）。