企业官网建设流程全解析

如果你的 C 盘常年亮着红色警告，而 Android Studio 安装目录、Android SDK、Gradle 缓存、AVD 模拟器镜像加起来轻松占掉 30~50 GB，那么这篇路径迁移指南就是给你准备的。我自己的开发机当初也是被 Android 开发环境塞到只剩几个 GB，迁移完直接多出 40 多 GB 可用空间，而且 IDE 启动速度和构建速度反而更稳定了。这篇文章会从目录盘点开始，一步步告诉你哪些路径能搬、哪些路径不能乱动、怎么改配置才能让 Android Studio 仍然正常识别 SDK 和模拟器，最后还会分享我实际操作中踩过的几个坑。

适合正在被 C 盘空间逼疯的 Android 开发者，也适合刚入职新电脑、想从一开始就把 Android 开发环境放到非系统盘的初学者。下面所有操作都在 Windows 11 上实测过，Windows 10 大同小异。

1. 动手迁移前，先搞清楚 C 盘上到底谁在占地方

很多人以为把 Android Studio 的安装包装到 D 盘就万事大吉，其实那只占了整个开发环境的一小部分。真正吃掉 C 盘空间的，是安装完成后系统在你用户目录下自动生成的缓存和配置文件夹。如果不把这些摸清楚，迁移做到一半就会发现还有漏网之鱼。

1.1 Android Studio 占空间的五个主要目录

我根据日常开发中观察到的体积情况，整理了一张表，你可以在迁移前按图索骥去检查自己的磁盘占用：

这五个里面，最容易爆掉的是 SDK 和.gradle目录。尤其是 SDK 里的system-images和emulator目录，只要你创建过几个不同 API 级别的模拟器，二三十 GB 就没了。而.gradle目录则是每次构建时下载的各种依赖包累积出来的，项目一多，体积增长非常快。

1.2 为什么要用“迁移”而不是“重装”

有人可能会说：干脆把 Android Studio 卸载重装到 D 盘不就行了？但重装意味着之前所有的插件、快捷键配置、已登录的账号、项目列表、SDK Manager 里的下载历史全都要重新来一遍，而且 SDK 和 Gradle 缓存还是在用户目录下重新生成，C 盘照样被吃。迁移的优势在于保留现有配置和缓存，只是把物理文件挪个位置，再通过环境变量和 IDE 设置把“新家”告诉系统。整个过程不需要重新下载几十 GB 的工具链，省时省力，风险也更低。

我是建议把“迁移”理解成三步：第一步搬文件，第二步改配置，第三步验证。不要直接剪切乱放，否则 Android Studio 会按老路径去找文件，找不到就只能报错给你看。

1.3 迁移前先记录当前的关键路径

开工之前，打开 Android Studio，依次选择File -> Settings -> Build, Execution, Deployment -> Gradle，把Gradle user home的值记下来；再打开File -> Settings -> Appearance & Behavior -> System Settings -> Android SDK，把Android SDK location记下来。这两个路径是后续操作的核心参照。如果你用的是命令行构建工具，还要打开终端执行echo %ANDROID_HOME%和echo %GRADLE_USER_HOME%，确认系统里是否已经存在这些环境变量，免得迁移后生效的是旧值。

2. 迁移前的检查：目标盘选择与数据备份策略

这一节不少人会跳过，但恰恰是决定迁移能否一次成功的关键。你先别急着复制粘贴文件夹，按照下面的顺序做，能避免九成以上“迁移完 IDE 打不开”的问题。

2.1 目标盘格式和剩余空间怎么判断

目标盘建议是 NTFS 格式的固态硬盘。判断方法很简单：在“此电脑”里右键目标盘，选“属性”，文件系统如果是 NTFS 就没问题；如果是 FAT32 或 exFAT，那要慎重，因为单个超过 4 GB 的模拟器镜像可能拷不进去。剩余空间建议至少预留目标文件总大小的 2 倍，比如要迁移 30 GB 的 SDK，那目标盘至少要有 60 GB 空余，因为复制过程中的临时文件可能占用不少空间。

我个人推荐把目标根目录定成类似D:\DevTools这种浅层路径，不要嵌套太深。太深的长路径在 Android Studio 里可能触发 Windows 的路径长度限制，出现莫名其妙的“File name too long”。后续所有需要迁移的目录都放在这个根目录下，结构清爽，也方便以后整理环境变量。

2.2 需要备份哪些数据

迁移虽然不删除任何东西，但为了应对中途断电、复制中断、误操作覆盖，还是建议做一次轻量备份。重点备份：

• %USERPROFILE%\.android里的avd目录下的.ini文件和.avd文件夹，这里面是模拟器数据，丢了就得重新创建。
• %USERPROFILE%\.gradle\gradle.properties和caches\下的自定义配置，如果你在里面配过镜像地址或本地仓库路径，别漏。
• Android Studio 的keymaps、options、templates等配置文件目录，迁移后一般不需要备份，但如果你想保险，可以把整个配置文件夹压缩一份放到网盘。

备份不是让你打包成几个 GB 的压缩包带着走，而是把关键配置和模拟器 ini 文件复制一份到别的盘，避免万一复制过程中损坏导致无法恢复。我实测下来，复制文件本身很少出错，出错往往出在“电脑休眠导致复制中断”这种意外上。

2.3 关闭 Android Studio 和所有 Java 进程

这一步非常关键。很多人迁移时 Android Studio 还开着，结果复制到一半提示“文件正在被占用，无法访问”。正确的做法是：

1. 保存所有项目，退出 Android Studio。
2. 打开任务管理器，确认没有java.exe、adb.exe、emulator.exe、studio64.exe这些进程残留。
3. 如果发现 adb 还在，可以在命令行执行adb kill-server。

确定没有进程占用后，再进行文件复制才算稳妥。这个细节我在第一次迁移时忽略了，结果.android目录里的ddms相关文件被锁定，复制出来的 AVD 数据不完整，后来花了不少时间才修复模拟器。

3. 主体迁移：从 IDE 安装目录到 SDK 和 Gradle 的完整过程

现在开始正式操作。我按“从外到内、从程序本体到用户数据”的顺序来：先迁 Android Studio 安装目录，再迁 Android SDK，最后迁 Gradle 缓存和 IDE 配置目录。这个顺序好处是每改完一个路径，后面依赖它的配置就能跟着确认，不容易出现“先改了 SDK 路径，后面 IDE 安装目录又变了导致找不到 JBR”的问题。

3.1 Android Studio 安装目录：直接改安装路径不可取，用快捷方式或重装

如果你最初把 Android Studio 装在 C 盘Program Files下，最简单的方法是在控制面板里卸载，然后重新安装到目标盘。不过卸载会丢失个人配置吗？不会，配置都在用户目录下的AppData\Roaming\Google\AndroidStudioX.Y，卸载程序不会自动清除那个目录。所以这种方法其实是干净的：安装到新路径后，之前的插件和快捷键配置都会在。

如果你不想重新下载安装包，也可以用文件复制加修改快捷方式的方法，但需要注意：Android Studio 安装目录里有一个bin\idea.properties文件，里面记录了 IDEA 的系统目录位置。如果只是把安装目录从 C 盘挪到 D 盘，需要同步修改快捷方式里的启动路径，否则快捷方式会失效。更关键的是，Android Studio 在启动时还会根据安装路径计算某些内部路径，所以“直接剪切整个目录到 D 盘然后双击 D 盘里的 exe”这个方案在新版本上有可能触发启动异常，不建议这么干。

我实际推荐的做法是：花几分钟去官网重新下载安装包，安装时把路径选成D:\DevTools\Android Studio。反正现在的安装包也不大，安装过程基本不需要手动干预。如果你有特殊需求不想重下，可以在 C 盘保留一个“启动器快捷方式”指向新路径，但这属于非标准玩法，不建议写进团队文档。

3.2 Android SDK：复制目录之后用 sdkmanager 修正路径

SDK 是体积最大的一块，也是迁移后最容易出问题的一块。步骤分三步：

第一步：完整复制C:\Users\你的用户名\AppData\Local\Android\Sdk到D:\DevTools\Android-Sdk。注意用复制而不是剪切，复制完先别删 C 盘原目录，等后面验证通过再删。复制时间取决于 SDK 大小，可能需要几分钟到十几分钟，保持电脑不要休眠。

第二步：打开 Android Studio，进入File -> Settings -> Appearance & Behavior -> System Settings -> Android SDK，把Android SDK Location改成D:\DevTools\Android-Sdk。点Next或Finish，Android Studio 会检测目标路径下的 SDK 组件。如果检测正常，说明复制成功；如果提示某些组件缺失，可以点开 SDK Manager，把缺失的组件重新下载。

第三步：设置环境变量。在 Windows 搜索栏输入“编辑系统环境变量”，打开“环境变量”窗口，在“用户变量”里新增或修改：

变量名: ANDROID_HOME 变量值: D:\DevTools\Android-Sdk

另外再新增一个ANDROID_SDK_ROOT，值同样指向D:\DevTools\Android-Sdk。我建议两个变量都设置，因为现在很多构建工具和插件会读取其中一个，为了兼容，两个都设更保险。设置完记得重启终端再测试，执行echo %ANDROID_HOME%查看结果。

这里有个常见误区：直接修改local.properties文件里的sdk.dir来指向新路径。这只对单个项目有效，但换一个新项目、或者用命令行构建时又会去读ANDROID_HOME，带来不一致。所以要全局调整，就改动环境变量和 IDE 设置，双管齐下最稳定。

3.3 Gradle 缓存：通过 GRADLE_USER_HOME 让你所有项目共享新路径

Gradle 缓存默认在C:\Users\你的用户名\.gradle，里面有几个 GB 到十几 GB 的依赖包。迁移它比迁移 SDK 更隐蔽，因为 Android Studio 的项目里可能还配置了 Gradle wrapper 的 distributionPath，不走到那一步你根本意识不到占了多少空间。

操作流程：

1. 把%USERPROFILE%\.gradle整个复制到D:\DevTools\Gradle-Home。
2. 打开系统环境变量，新增用户变量：

变量名: GRADLE_USER_HOME 变量值: D:\DevTools\Gradle-Home

3. 进入 Android Studio 的Settings -> Build, Execution, Deployment -> Gradle，把Gradle user home改成D:\DevTools\Gradle-Home。

有些项目用的是项目内自带的 Gradle 版本，迁移后首次构建会在新路径下生成wrapper\dists目录，这是正常的，只要之前复制过来的缓存里有对应版本的dists，就不会重新下载。如果你发现某个项目构建时疯狂下载 Gradle，大概率是GRADLE_USER_HOME里的wrapper/dists没有复制全，或者目标路径下权限不足导致读取失败。这时候检查一下防病毒软件有没有拦截写入，确认路径里没有中文和空格。

3.4 Android Studio 配置目录与 AVD 模拟器：两个容易忽略的大家伙

Android Studio 的全局配置在%APPDATA%\Google\AndroidStudioX.Y，比如版本是AndroidStudio2023.1那种目录。这个目录里有options、plugins、log、index等。体积不大，但如果你安装了很多插件，可能也有 2~3 GB。迁移方法是在 IDE 的启动参数里指定一个新的系统目录。

具体做法：找到 Android Studio 安装目录下bin\studio64.exe.vmoptions文件（或者通过Help -> Edit Custom VM Options打开），在里面加一行：

-Didea.system.path=D:/DevTools/AndroidStudio-System -Didea.config.path=D:/DevTools/AndroidStudio-Config

注意路径中的反斜杠要改成斜杠或双反斜杠，否则可能不生效。修改前先把AppData\Roaming\Google\AndroidStudioX.Y复制到D:\DevTools\AndroidStudio-Config，把AppData\Local\Google\AndroidStudioX.Y复制到D:\DevTools\AndroidStudio-System。然后重启 IDE。如果启动正常，说明配置目录迁移成功，之后 IDE 的索引、缓存、插件都会写到新路径。

接着是模拟器 AVD。很多人不知道，AVD 的镜像文件默认放在%USERPROFILE%\.android\avd目录下。这个目录可能高达十几 GB，必须一起迁。步骤：

1. 复制%USERPROFILE%\.android到D:\DevTools\Dot-Android。
2. 原有的%USERPROFILE%\.android\avd\里会有一个设备名.avd文件夹和一个设备名.ini文件。
3. 用文本编辑器打开.ini文件，找到类似path=C:\Users\你的用户名\.android\avd\Pixel_8_API_34.avd的行，把路径改成D:\DevTools\Dot-Android\avd\Pixel_8_API_34.avd。
4. 保存后，关闭所有防火墙和杀毒软件对 avd 文件夹的扫描，避免启动模拟器时反复校验路径。

同时还要修改环境变量ANDROID_AVD_HOME指向D:\DevTools\Dot-Android\avd，这样 Android Studio 才能找到 AVD 列表。不信你试试，如果不改这个变量，即使你改了.ini文件，模拟器列表也可能刷新不出来。

3.5 项目内的 build 目录：不需要迁移，但值得清理

最后再补一个瘦身技巧：项目里的build目录和.gradle文件夹是每个项目重复生成的，不属于 Android Studio 全局环境。迁移后如果 C 盘还是紧张，建议清理掉这些临时构建产物。用 Android Studio 的Build -> Clean Project，或者直接删除项目下的build文件夹、app/build文件夹，它们在下次构建时会重新生成。不要删src、不要删gradle目录（除非你确认不需要），否则项目就废了。

如果要批量清理，可以在项目根目录执行命令行：

for /d /r %dir in (build .gradle) do rd /s /q "%dir"

当然，前提是你已经用 Git 管理项目，删了一点都不心疼。这个清理不会影响最终的 APK 产物，只会让你的电脑多出几个 GB 空间。

4. 迁移之后的配置修正：别让 IDE 找不着北

文件搬完了，路径也改了，但如果漏掉一些隐藏设置，Android Studio 打开项目时会提示各种 SDK、Gradle、JVM 相关的报错。这一节我们做一次系统性的“路径修正”，把能想到的关联设置全部对齐到新路径。

4.1 环境变量的完整清理与设置清单

很多老开发者的电脑上会同时存在ANDROID_HOME、ANDROID_SDK_ROOT、ANDROID_AVD_HOME、GRADLE_USER_HOME、JAVA_HOME这些变量。迁移后最怕的是旧变量还指向 C 盘路径。我建议打开系统环境变量面板，把所有与 Android、Gradle、Java 相关的用户变量都检查一遍，按下面清单确认：

环境变量修改后，记得重启所有已打开的终端和 Android Studio，让新值生效。Windows 下环境变量不会实时刷新到已运行的程序中，这是最常见的“改了但没效果”的原因。

4.2 修改 project 级别的 local.properties

如果你打开的每一个老项目里都有local.properties文件，里面保存着项目专用的 SDK 路径。迁移后这个文件仍会指向 C 盘旧路径。要么手动逐个改，要么干脆删除它，让 Android Studio 重新根据ANDROID_HOME生成。

保险起见，我建议先手动打开几个项目的local.properties，把sdk.dir改成新路径，然后同步到 Git。如果是临时拉下来的新项目，直接删掉这个文件，让 Gradle 去识别环境变量。注意这个文件不要提交到版本控制，它本来就应该在本地存在。

有些项目还可能用到.gradle\gradle.properties里的org.gradle.java.home，如果你之前手动指定过 JDK 路径，迁移后也要同步修改，否则构建时会用你 C 盘里已经不存在的 JBR 路径，直接报“Unable to locate a Java Runtime”。

4.3 修改 Android Studio 的 JDK 配置

Android Studio 新版通常使用内置的 JBR，环境变量一般不用手动设置。但如果你在项目结构里手动设置了 JDK 路径为C:\Program Files\Android\Android Studio\jbr，那么安装目录迁移后，这个路径就失效了。打开File -> Project Structure -> SDK Location，把 JDK 位置改成新安装目录下的jbr子目录，例如D:\DevTools\Android Studio\jbr。

记得还要检查File -> Settings -> Build Tools -> Gradle里的 Gradle 版本与 JDK 版本是否匹配。如果你之前设置了多个 Gradle 版本，迁移后可能有些版本的缓存不在新路径下，需要重新下载。这个没法完全避免，但可以通过把.gradle目录复制完整来减少下载量。

4.4 验证 cmd 命令行工具正常读取新路径

除了 IDE 界面，命令行工具是最容易遗漏的一环。打开新的命令提示符，逐个执行以下命令并确认输出路径都是新目录：

• echo %ANDROID_HOME%
• echo %GRADLE_USER_HOME%
• where adb：如果 adb 在新 SDK 目录下，应该显示D:\DevTools\Android-Sdk\platform-tools\adb.exe
• where java：确认不是指向旧的 Android Studio 目录

如果where adb仍然显示 C 盘路径，检查系统的PATH环境变量里是否有旧路径，手动删除或更新。这是很多人忽略的一步，我见过有人 SDK 路径都改完了，命令行敲adb还能跑起来，但用的其实是另一个老旧 SDK，调试时版本不匹配，莫名其妙的 bug 全来了。

5. 迁移后验证与收尾：确保 C 盘真的瘦下来了

路径改完不等于结束，我们得实际跑一轮构建和模拟器，确认整个工具链都正常，然后才能放心删除 C 盘旧文件。

5.1 打开一个项目进行一次完整 Gradle 构建

随便找一个依赖比较多的项目，在 Android Studio 里执行一次Build -> Rebuild Project。觀察三个点：

1. 构建日志里有没有红色报错，特别是有没有Could not find、SDK location not found、Gradle distribution ... not found这类信息。
2. 打开 Gradle 窗口，看依赖刷新耗时。如果新路径下没有对应缓存，首次构建会重新下载所有依赖，时间会比较长，这是正常的。
3. 构建完成后，去D:\DevTools\Gradle-Home\caches里看看是否生成了modules-2目录，里面应该有大量.aar、.jar文件。

如果一切正常，说明 Gradle 缓存迁移成功。此时再回头看 C 盘的空间，应该已经多出十几个 GB。如果仍然没变，说明还有旧目录在 C 盘上占用，继续往下检查。

5.2 启动模拟器测试 AVD 路径生效

在 Android Studio 里点击 Device Manager，看看能否正常显示已有的 AVD 列表。如果列表为空，先检查ANDROID_AVD_HOME环境变量和.ini文件路径。如果列表能显示，但启动后模拟器黑屏或卡在启动动画，大概率是.avd文件夹里的userdata.img或快照文件复制不完整。

我遇到过一种情况：AVD.ini文件里的路径改了，但.avd文件夹里某个配置文件（如config.ini）里面的image.sysdir.1路径还指向 SDK 的旧路径。这时只需把config.ini里 SDK 相关的路径同步改成新 SDK 路径即可。启动模拟器后，观察启动日志，确认没有Cannot find AVD system path类似提示就算通过。

5.3 删除 C 盘旧目录的顺序与安全策略

验证全部通过后，才能开始释放空间。删除顺序有讲究：

1. 先删C:\Users\你的用户名\.android旧备份？不对，应该是先删除旧的 SDK 目录和.gradle目录，因为这两个是空间大头。
2. 删除前建议不要直接按 Shift+Delete 永久删除，可以先重命名成.bak文件放到回收站，等过几天确认系统完全稳定后再清空回收站。
3. 如果安装了新版 Android Studio 到 D 盘，卸载旧版后，C 盘Program Files\Android目录可能残留，手动删除或通过控制面板卸载。

删除旧目录后，C 盘可用空间会大幅增加。但有一点要注意：千万不要把AppData\Local\Android\Sdk整个删掉之前，忘了确认ANDROID_HOME已经指向新路径。如果顺序反了，在 Android Studio 里打开项目可能直接找不到 SDK，到时候还得重新设置，比较麻烦。

建议的收尾步骤是：

• 先确认环境变量全部指向新路径。
• 再执行一次完整构建和模拟器启动。
• 确认无误后，把旧 SDK 目录、旧.gradle目录、旧.android目录全部重命名加.old后缀。
• 再重启一次 Android Studio 验证一次。
• 最后真正删除这些.old目录。

5.4 关于 C 盘空间释放幅度的实测数据

在我的机器上，迁移前 C 盘占用约 210 GB，其中 Android Studio 相关目录约 47 GB。迁移完成后，C 盘剩余空间从 8 GB 涨到 52 GB，涨幅 40 多 GB。这个数字对大多数开发者来说都是非常可观的。

如果迁移后你的 C 盘依然紧张，下一步可以检查 Windows 自带的“存储感知”是否开了，并把虚拟内存、休眠文件挪到非系统盘，但这些就不属于 Android Studio 的范畴了，此处不展开。

6. 实操中容易踩的坑：我替你先试过了

写到最后，把我在迁移过程中遇到的最典型的几个坑总结一下。这些坑比较隐蔽，文档里通常不会写，但崩起来相当吓人。

6.1 复制到一半电脑休眠，目录损坏

我第二次迁移时，复制 SDK 目录用了大概 15 分钟，结果中途电脑休眠，复制过程被中断。醒来后emulator目录下某些文件损伤，启动模拟器直接崩溃。后来我是用robocopy命令来做复制的，它可以带/MT多线程参数，速度更快，而且支持断点续传。强烈推荐用命令行复制：

robocopy "C:\Users\你的用户名\AppData\Local\Android\Sdk" "D:\DevTools\Android-Sdk" /E /MT:16 /R:3 /W:1

参数含义是：/E复制所有子目录（含空目录），/MT:16用 16 线程并行复制，/R:3失败重试 3 次，/W:1每次重试间隔 1 秒。用这种方式，几乎不会出现复制一半卡死的现象。

6.2 防病毒软件把 AVD 镜像当高风险文件处理

Windows Defender 或者其他安全软件有时会扫描.avd目录里的用户数据文件，导致模拟器启动时反复读取失败。遇到一个奇怪的现象：模拟器能打开，但加载非常慢，甚至卡在“Starting emulator”界面。解决办法是把D:\DevTools\Dot-Android目录加入杀毒软件的排除列表。这一步虽然不是必须的，但能省很多等待时间。

6.3 Android Studio 索引缓存导致 UI 显示旧路径

迁移后即使所有配置都改对了，Android Studio 的索引缓存里可能还是旧的路径信息，导致“SDK Location”界面显示的是当前无效路径。这时候执行一次File -> Invalidate Caches / Restart，让 IDE 重建索引。如果还是不生效，可以手动删除D:\DevTools\AndroidStudio-System\index目录，再重启 IDE。

6.4 多个用户账号导致的路径串台

如果你的开发机上有多个 Windows 用户账号，且都有 Android 开发环境，迁移时要注意每个用户目录下都有独立的.gradle、.android和AppData目录。你只迁移当前账号，另一个账号登录时还是会读取 C 盘旧目录。如果团队公用的电脑，建议每个开发者各自执行一遍迁移，或者统一把环境变量改成同一套全局变量。

7. 迁移完成的后续建议：让 C 盘一直保持清爽

迁移完成后，最好不要让 Android Studio 再把任何缓存写回 C 盘。做到这点并不难，只要养成几个习惯：

• 安装新 SDK 组件时，SDK Manager 下载位置会自动定位到新 SDK 路径，不需要额外设置。
• 新创建项目时，如果 IDEA 默认把项目放在C:\Users\用户名\AndroidStudioProjects，可以在Settings -> Project Defaults里把默认项目目录改成D:\DevTools\Projects。
• Gradle 新版本更新时，GRADLE_USER_HOME依然指向新路径，只要环境变量不变，缓存就永远在 D 盘。
• 定期用磁盘分析工具扫描 C 盘，看看是否有新的AppData缓存目录悄悄膨胀。我一般每两个月扫一次，发现不对的思路就顺手清理。

我个人在实际操作中的最大体会是：迁移不是“一次编辑配置”的事，而是一个系统性整理环境的过程。做完这一轮，你不仅释放了几十个 GB，还会对 Android 开发环境的目录结构有一个更清晰的认识。以后遇到“C 盘又被塞满”的同事，你也可以把这套流程完整地讲给他听。希望这篇路径迁移指南能帮你的 Android Studio 轻装上阵，开发机重新呼吸起来。