方法一:通过环境变量全局修改(推荐)
关闭 Android Studio
确保所有项目和 Android Studio 已完全退出。
创建目标文件夹
在目标磁盘(如D:\Android)下新建文件夹,例如:
D:\Android\.gradle
设置系统环境变量
按Win + S搜索“环境变量”,选择“编辑系统环境变量”。
点击“环境变量”“系统变量”“新建”。
输入变量名和值:
变量名:GRADLE_USER_HOME
变量值:D:\Android\.gradle
点击确定保存所有窗口。
验证是否生效
重启 Android Studio,打开任意项目。
检查新路径(如D:\Android\.gradle)下是否生成caches、wrapper等子文件夹。
方法二:修改项目级 gradle.properties(仅限当前项目)
定位gradle.properties文件
在项目的根目录中找到gradle.properties文件(若不存在则新建)。
添加配置
在文件中加入以下内容(替换为你的路径):
systemProp.gradle.user.home=D:/Android/.gradle
注意:路径使用正斜杠/,避免反斜杠转义问题。
同步项目
重启 Android Studio,点击“Sync Project with Gradle Files”。
观察 Gradle 是否将依赖下载到新路径。
方法三:使用符号链接(高级操作)
移动现有.gradle文件夹
关闭 Android Studio。
将默认的.gradle文件夹(位于C:\Users\你的用户名\.gradle)剪切到目标磁盘,例如:
D:\Android\.gradle
创建符号链接
以管理员身份打开命令提示符,执行:
mklink /J "C:\Users\你的用户名\.gradle" "D:\Android\.gradle"
确保原路径(如C:\Users\你的用户名\.gradle)已删除。
验证链接
重启 Android Studio,检查项目是否能正常同步。
注意事项
路径权限问题
确保目标磁盘的文件夹有读写权限(右键文件夹 属性 安全 编辑权限)。
首次同步耗时
迁移后首次构建项目需重新下载依赖,时间较长(取决于网络)。
多用户系统
若系统有多个用户账户,需为每个账户单独设置GRADLE_USER_HOME环境变量。
IDE 兼容性
Android Studio 版本不同可能影响配置方式,建议优先使用方法一(环境变量)。
领取专属 10元无门槛券
私享最新 技术干货