黄小秋1. 为什么需要修改Gradle路径？
每次打开Android Studio新建项目时，总会在C盘用户目录下生成.gradle文件夹。这个文件夹随着项目增多会变得越来越大，尤其是缓存文件可能占用数十GB空间。对于系统盘空间紧张或习惯将开发环境统一管理的开发者来说，修改默认存储路径是个硬需求。
我遇到过最极端的情况是.gradle文件夹占用了120GB空间，导致C盘爆满。更麻烦的是，当需要重装系统时，所有缓存和配置都会丢失，不得不重新下载大量依赖库。通过修改Gradle路径，我们可以实现三个核心目标：
- 释放系统盘空间 - 将缓存文件转移到其他分区
- 统一管理开发环境 - 所有配置和缓存集中存放
- 便于备份和迁移 - 重装系统不影响开发环境
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 修改Gradle路径的三种方式
2.1 通过环境变量全局修改（推荐）
这是最彻底的方法，对所有项目生效。具体步骤：
- 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
- 在系统变量中新建：
- 变量名：GRADLE_USER_HOME
- 变量值：D:\Android\gradle (自定义路径)
- 重启Android Studio使配置生效
注意：路径不要包含中文或空格，否则可能导致未知错误
2.2 修改项目级gradle.properties
适用于单个项目配置，优先级高于全局设置：
- 在项目根目录的gradle.properties文件中添加：
properties复制systemProp.gradle.user.home=D:/Android/gradle - 同步项目（Sync Now）
实测发现这种方式有时会被IDE覆盖，建议配合方法一使用
2.3 修改Android Studio配置
临时方案，仅影响当前IDE实例：
- File → Settings → Build,Execution,Deployment → Gradle
- 修改"Gradle user home"路径
- 点击Apply保存
这种方式配置不会持久化，重装IDE后需要重新设置
3. 迁移已有Gradle缓存
直接修改路径会导致已有项目找不到缓存，需要手动迁移：
bash复制# 关闭Android Studio
# 将原.gradle文件夹整体复制到新位置
# 保持文件夹结构一致
# 删除原目录下的caches/文件夹（可重新下载）
迁移后首次构建会较慢，因为需要重新生成部分索引文件。建议在非工作时间操作。
4. 国内开发者的特殊配置
4.1 镜像源加速
在gradle.properties中添加：
properties复制systemProp.http.proxyHost=mirrors.cloud.tencent.com
systemProp.http.proxyPort=80
systemProp.https.proxyHost=mirrors.cloud.tencent.com
systemProp.https.proxyPort=80
4.2 离线模式配置
当网络不稳定时启用：
properties复制org.gradle.parallel=true
org.gradle.caching=true
org.gradle.configureondemand=true
5. 常见问题排查
5.1 路径修改无效
检查顺序：
- 环境变量是否包含特殊字符
- 是否有多个gradle.properties冲突
- IDE是否以管理员权限运行
5.2 构建速度变慢
优化方案：
- 删除.gradle/caches/下的transforms-*文件夹
- 增加gradle.properties中的堆内存：
properties复制org.gradle.jvmargs=-Xmx4096m -XX:MaxPermSize=512m
5.3 文件权限问题
Linux/Mac下需要确保新路径有读写权限：
bash复制chmod -R 755 /new/path
6. 高级技巧
6.1 符号链接方案
对于无法修改环境变量的环境，可以使用mklink创建符号链接：
cmd复制mklink /J C:\Users\xxx\.gradle D:\Android\gradle
6.2 多版本Gradle管理
在不同项目中使用不同Gradle版本：
properties复制# 在gradle-wrapper.properties中指定
distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
6.3 自动化清理脚本
创建clean_gradle.bat定期清理：
bat复制@echo off
set GRADLE_PATH=D:\Android\gradle
del /s /q "%GRADLE_PATH%\caches\transforms-*"
经过这些配置后，我的构建时间从平均3分钟缩短到40秒，C盘空间释放了87GB。建议每个Android开发者都尽早进行路径优化，特别是使用固态硬盘作为系统盘的情况下