android——Android Studio 路径迁移指南（释放 C 盘空间）

1. 问题引入

使用 Windows 系统开发时，你是否经常遇到 Android Studio 导致 C 盘空间告急的情况？😲

这是因为 Android Studio 默认将核心数据文件存储在系统盘的用户目录（C:\Users\用户名\）下，主要包含三类占用空间较大的文件：

• .android：存放 Android 模拟器镜像文件（单镜像可达数 GB）
• .gradle：存放 Gradle 构建工具、依赖包缓存
• .AndroidStudio：存放 AS 的配置、插件、日志、缓存等文件

版本说明：部分 AS 版本无.AndroidStudio目录，相关文件会分散在C:\Users\用户名\AppData\Local\Google\AndroidStudioXXX和C:\Users\用户名\AppData\Roaming\Google\AndroidStudioXXX（XXX 为版本号）。本文演示环境：Android Studio Narwhal 4 Feature Drop | 2025.1.4 Build #AI-251.27812.49.2514.14217341

随着开发项目增多，这些文件会持续累积，最终导致 C 盘可用空间急剧减少。本文将详细讲解如何迁移这三类文件的存储路径，彻底解决 C 盘占用过高的问题。

2. 操作步骤

2.1 修改 .android 路径

核心原理：通过配置系统环境变量ANDROID_SDK_HOME指定新路径，步骤如下：

1. 打开环境变量配置面板：「此电脑」右键 → 属性 → 高级系统设置 → 高级 → 环境变量

1. 在「系统变量」区域点击「新建」：
   • 变量名：ANDROID_SDK_HOME
   • 变量值：自定义非 C 盘路径（禁止包含中文 / 空格 ），示例：E:\Android\ASData\.android
2. 点击「确定」保存，关闭所有配置窗口。

2.2 修改 .gradle 路径

核心原理：通过环境变量GRADLE_USER_HOME指定 Gradle 缓存新路径，操作流程与上文一致：

1. 打开环境变量配置面板（同上）；
2. 在「系统变量」区域点击「新建」：
   • 变量名：GRADLE_USER_HOME
   • 变量值：自定义非 C 盘路径（禁止包含中文 / 空格 ），示例：E:\Android\ASData\.gradle
3. 点击「确定」保存。

2.3 修改 .AndroidStudio 路径

核心原理：修改 AS 安装目录下的idea.properties配置文件，指定配置 / 缓存新路径：

1. 找到idea.properties文件位置（以示例路径为例）：E:\Android\android-studio-2025.1.4.8-windows\android-studio\bin\idea.properties

2. 右键选择「记事本」打开该文件；

3. 找到以下注释行，在其下方添加自定义路径配置（** 路径分隔符用 / 而非 **）： properties

   

   # 原配置（注释状态）
   # idea.config.path=${user.home}/.AndroidStudio2025.1.4/config
   # 新增自定义配置
   idea.config.path=E:/Android/ASData/.AndroidStudio/config
   
   # 原配置（注释状态）
   # idea.system.path=${user.home}/.AndroidStudio2025.1.4/system
   # 新增自定义配置
   idea.system.path=E:/Android/ASData/.AndroidStudio/system

4. 保存文件并关闭（修改前建议备份原文件）。

3. 验证操作

完成上述配置后，重启 Android Studio，首次启动会进入初始化引导界面（类似新安装），这是正常现象，按引导完成初始化即可。

3.1 验证 .android 路径修改效果

1. 启动 AS 后，原模拟器列表会清空（因数据已迁移）；
2. 新建一个模拟器，检查新路径下是否生成文件：示例路径：E:\Android\ASData\.android\avd（系统自动嵌套一层.android属于正常现象）；
3. （可选）如需迁移旧模拟器：
   • 将旧路径（C:\Users\用户名\.android\avd）下的模拟器文件夹剪切到新路径；
   • 编辑模拟器文件夹内的xxx.ini文件，将其中的path值改为新路径。

3.2 验证 .gradle 路径修改效果

1. 新建一个 Android 项目，AS 会自动下载 Gradle 依赖；
2. 验证方法：
   • 打开 AS → File → Settings → Build, Execution, Deployment → Gradle；
   • 查看「Gradle user home」是否为自定义的新路径（如E:\Android\ASData\.gradle）；
3. （可选）将旧路径下的 Gradle 缓存文件剪切到新路径，可避免重复下载。

3.3 验证 .AndroidStudio 路径修改效果

1. AS 启动后，会自动在新路径（如E:/Android/ASData/.AndroidStudio/）生成config和system文件夹；
2. 检查新路径下是否有文件生成，确认配置生效；
3. 原插件需重新安装（新路径无旧插件缓存），安装后插件数据会存储在新路径。

4. 清理旧文件

待所有新路径验证生效后，即可安全删除 C 盘旧文件，释放空间：

1. 删除C:\Users\用户名\下的.android、.gradle、.AndroidStudio文件夹；
2. 若为新版 AS，额外删除C:\Users\用户名\AppData\Local\Google\AndroidStudioXXX和C:\Users\用户名\AppData\Roaming\Google\AndroidStudioXXX下的log、caches、plugins等文件夹；
3. ✅ 完成后查看 C 盘空间，确认已释放占用的存储空间。

---

总结

1. 核心优化点：通过环境变量 + 配置文件修改三类核心文件的存储路径，彻底迁移出 C 盘；
2. 关键注意事项：自定义路径禁止包含中文 / 空格，路径分隔符统一用/，修改配置后需验证生效再删除旧文件；
3. 实操技巧：迁移旧缓存 / 模拟器文件可减少重复下载 / 重建，节省时间。