最稳定方式是通过系统环境变量gradle_user_home重定向.gradle路径至d盘。需关闭android studio、新建环境变量、剪切原.gradle文件夹至新路径、重启生效，确保所有gradle调用（ide、命令行、ci）统一使用新缓存位置。
Win10系统中Gradle构建缓存持续膨胀，C盘空间被 Gradle 用户主目录（【C:\Users\你的用户名\.gradle】）大量占用，导致Android Studio卡顿、系统提示磁盘空间不足，必须将整个.gradle文件夹从C盘迁移到D盘或其他非系统盘，且确保所有项目、命令行和IDE均识别新路径，避免重复下载依赖。
通过系统环境变量彻底重定向.gradle路径
这是最底层、最稳定的方式，对Android Studio、命令行终端（cmd/PowerShell）、CI脚本全部生效，无需修改任何IDE配置或项目文件。
第一步：关闭Android Studio及所有Java进程（可在任务管理器中结束“java.exe”和“studio64.exe”相关进程）。
第二步：打开系统环境变量设置——右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
第三步：在“系统变量”区域点击“新建”，填入：
变量名：GRADLE_USER_HOME
变量值：D:\Android\.gradle（请确保该路径所在磁盘有足够空间，且路径中不含中文、空格或特殊符号）。
第四步：将原C盘的完整.gradle文件夹剪切（不是复制）到新路径D:\Android\.gradle。注意：必须包含caches/、wrapper/、daemon/等全部子目录，否则Gradle会当作全新环境重新下载所有依赖。
第五步：重启电脑（或至少重启所有终端和IDE），使环境变量全局生效。之后执行gradle -v或./gradlew --version，输出中的“Gradle User Home”将显示为D:\Android\.gradle。
通过Android Studio设置界面临时生效
该方法仅影响Android Studio GUI内启动的Gradle任务，不作用于外部终端或CI流程，适合快速验证路径是否可写、权限是否正常。
方法一：快捷键进入设置
按Ctrl+Alt+S → 左侧导航栏展开 Build, Execution, Deployment → Build Tools → Gradle → 找到“Gradle user home”输入框，清空原有路径，填入D:\Android\.gradle → 点击OK。
方法二：菜单栏入口
File → Settings → Build Tools → Gradle → 修改Gradle user home → OK。
⚠️ 注意：此设置项优先级低于GRADLE_USER_HOME环境变量。若已设置环境变量，此处修改无效；只有在环境变量未设置时才起作用。
验证迁移是否成功
打开Android Studio，打开任意一个已有项目，执行Build → Make Project。
观察底部Build窗口日志，查找类似以下内容：
“Using gradle user home: D:\Android\.gradle”
打开文件资源管理器，手动访问D:\Android\.gradle\caches\modules-2\files-2.1，确认存在大量以com.android.support、androidx.*等开头的子目录——说明依赖缓存已正常写入新路径。
回到原C盘路径C:\Users\你的用户名\.gradle，确认该文件夹已为空或不存在（若还存在，请勿直接删除，先确认新路径构建无报错后再手动清理）。
