Android Studio 完全 D 盘化：4 类数据搬迁 + 3 个坑

Android Studio 完全 D 盘化：4 类数据搬迁 + 3 个坑

实操记录：从环境变量配置到首次启动踩坑的全过程。

引言

Android Studio 默认把 SDK、AVD 模拟器、Gradle 缓存、IDE 配置全塞 C 盘。SDK 装完 30 GB，Gradle 缓存动辄 50 GB——C 盘吃紧的人必看。

核心思路：IDE 程序本身不动（已经装在 D:\00_Software\01_Installers\android），只把4 类运行时数据从 C 盘搬到 D 盘。

1. 4 类数据搬迁清单

类别 默认 C 盘路径 目标 D 盘路径 配置方式
Android SDK C:\Users\World\AppData\Local\Android\Sdk D:\00_Software\Android\Sdk ANDROID_HOME
AVD 模拟器 C:\Users\World\.android\avd D:\00_Software\Android\avd ANDROID_AVD_HOME
Gradle 缓存 C:\Users\World\.gradle D:\00_Software\Android\.gradle GRADLE_USER_HOME
AS 配置 C:\Users\World\.AndroidStudio* D:\00_Software\Android\.config\AndroidStudio idea.properties

配置方式选择：环境变量 vs 自定义路径文件 → 推荐前者（标准、文档齐全、命令行工具也能复用）。

2. 4 步执行

第一步：创建 D 盘目录

1
2
3
4
New-Item -ItemType Directory -Force -Path "D:\00_Software\Android\Sdk"
New-Item -ItemType Directory -Force -Path "D:\00_Software\Android\avd"
New-Item -ItemType Directory -Force -Path "D:\00_Software\Android\.gradle"
New-Item -ItemType Directory -Force -Path "D:\00_Software\Android\.config\AndroidStudio"

第二步：配置系统环境变量

变量 值
ANDROID_HOME D:\00_Software\Android\Sdk
ANDROID_AVD_HOME D:\00_Software\Android\avd
GRADLE_USER_HOME D:\00_Software\Android\.gradle
Path 追加 %ANDROID_HOME%\platform-tools

注意：ANDROID_SDK_ROOT 已废弃，保留 ANDROID_HOME 即可（兼容旧脚本可加，新代码不要再用）。

第三步：迁移现有 C 盘数据

安全移动，不删原文件——先用 CopyItem 复制，验证完再手动删 C 盘旧数据：

1
2
3
Copy-Item -Path "D:\00_Software\01_Installers\andriod\*" -Destination "D:\00_Software\Android\Sdk" -Recurse -Force
Copy-Item -Path "$env:USERPROFILE\.android\avd\*" -Destination "D:\00_Software\Android\avd" -Recurse -Force
Copy-Item -Path "$env:USERPROFILE\.gradle\*" -Destination "D:\00_Software\Android\.gradle" -Recurse -Force

第四步：配置 AS 使用新配置目录

编辑 {IDE_HOME}\bin\idea.properties：

1
2
idea.config.path=D:/00_Software/Android/.config/AndroidStudio/config
idea.system.path=D:/00_Software/Android/.config/AndroidStudio/system

易忘点：路径用正斜杠 /，反斜杠 \ 在 properties 文件里要转义。

3. 首次启动向导的 3 个坑

坑 1：数据收集弹窗

选「Don’t send」——除非你明确愿意帮 Google 收集使用数据。

坑 2：Install Type 选 Standard 还是 Custom

选 Standard——它会读环境变量自动定位 D 盘 SDK。
不要选 Custom——Custom 会要求手动选 SDK 路径，反而绕弯。

坑 3：Standard 模式硬编码 C 盘 SDK

真实踩坑：选了 Standard 之后，SDK Folder 仍然指向 C 盘。

根因：改了环境变量没有启动新的终端，导致配置不生效，AS 的 Standard 模式仍使用 C 盘路径，无视新配置的ANDROID_HOME。

解法：

  1. 点 Cancel 关掉当前向导
  2. 重新打开新的电脑终端和 Android Studio
  3. 或者选 Custom（不是 Standard）
  4. 找到 SDK Folder 选择界面，手动改成 D:\00_Software\Android\Sdk
  5. 继续完成向导

关键认知：环境变量配对了 ≠ 立即生效，AS不 一定读到。Standard 读仍是旧的环境变量是 ，不是配置问题。

4. 验证清单

环境变量配完后用这 4 条命令验证：

1
2
3
4
echo $env:ANDROID_HOME           # 应输出 D:\00_Software\Android\Sdk
echo $env:GRADLE_USER_HOME       # 应输出 D:\00_Software\Android\.gradle
adb version                      # 应正常输出版本号
Get-ChildItem D:\00_Software\Android -Recurse -Depth 2

首次启动 AS 后再验证这 4 个目录是否生成内容：

  • D:\00_Software\Android\Sdk\emulator\platform-tools\build-tools（下载完 SDK 后）
  • D:\00_Software\Android\.gradle\caches（打开项目后）
  • D:\00_Software\Android\avd\*.avd（创建 AVD 后）
  • D:\00_Software\Android\.config\AndroidStudio\config\system（首次启动后）

5. 顺带修正：安装目录拼写

把 D:\00_Software\01_Installers\andriod（反拼）改成 android（正拼）：

1
Rename-Item "D:\00_Software\01_Installers\andriod" "android"

为什么可以现在改：AS 还没启动过，零快捷方式、零缓存、零插件扫描、零 PATH 引用——白板状态下改名零风险。

改名后启动路径：D:\00_Software\01_Installers\android\bin\studio64.exe

总结·3 条易忘点

  1. 环境变量要新开终端/AS 才会生效——配完关掉所有 PowerShell 和 AS 窗口重开
  2. 首次启动 Standard 模式会无视 ANDROID_HOME——SDK 指向 C 盘时立刻切 Custom 模式
  3. 拼写修正：andriod → android（未启动状态下改零风险）

行动建议

新机恢复步骤：装 AS → 配 4 个环境变量 → 改 idea.properties → 直接打开 AS 选 Custom 模式。

反向操作：删除 4 个环境变量 + 恢复 idea.properties 默认值，AS 会重新用 C 盘路径（不推荐，但应急时可用）。

长期策略：每次升级 AS 新版本前，把 D:\00_Software\Android\.config\AndroidStudio 整目录备份——配置不丢。