企业官网建设流程全解析

你有没有遇到过这种情况：Android Studio用的好好的，C盘突然就红了，磁盘空间告急，什么都不敢装。我最早被这个问题坑的时候，还以为是项目太大，后来一查才发现，真正吃掉C盘空间的不是代码，而是Android Studio默认放在C盘的SDK目录和一堆缓存文件。今天这篇就专门聊清楚一件事：怎么把AndroidStudio的SDK目录、Gradle缓存、模拟器镜像、系统缓存全部挪到D盘或其他大容量分区，一次性释放C盘空间，治标也治本。

这篇文章适合所有被C盘磁盘空间困扰的Android开发者，不管你是刚入门的新手，还是已经跑了几个项目的熟手，只要你的Android Studio默认装在C盘、SDK和缓存都走默认路径，看这一篇就够了。我写的内容全部来自实际操作，每一步都验证过，按顺序抄作业就能完成迁移，不用反复试错。

1. 摸清C盘空间的“大头”：它们到底都存在哪

1.1 四个占用大户的默认位置

先别急着动手搬家，搞清楚Android Studio默认把东西都放在哪里，才知道该迁什么、不迁什么。很多人以为Android Studio装在哪个盘，数据就在哪个盘，这是最大的误解。实际上，Android Studio从安装那一刻起，绝大多数用户级数据都走系统用户目录，也就是C盘。

我可以负责任地说，C盘空间消失，基本逃不出下面这四个目录：

• SDK目录：默认在C:\Users\你的用户名\AppData\Local\Android\Sdk。这里面装的是platforms、build-tools、platform-tools、system-images等组件。光是一个SDK，装齐常用版本和系统镜像，轻松吃掉10GB到30GB不止，这是C盘空间最大的一个独立占用源。
• Gradle用户目录：默认在C:\Users\你的用户名\.gradle。这里面有两个东西最占地方：一个是caches目录，存放所有项目依赖的jar包、aar包、AAR转换后的临时文件；另一个是wrapper\dists目录，存放每个项目用到的Gradle发行版压缩包和解压后的运行目录。每个Gradle发行版动辄100MB到200MB，依赖缓存的累积更是无底洞，二十几个GB的Gradle缓存目录我亲眼见过。
• AVD模拟器镜像：默认在C:\Users\你的用户名\.android\avd。每个AVD（Android Virtual Device）包含一个很大的磁盘镜像文件，常见的是2GB到8GB，如果你建了三四个不同API级别的模拟器，这部分空间加起来非常可观。
• Android Studio系统缓存：默认在C:\Users\你的用户名\.AndroidStudio2023.3（版本号不同目录名不同）以及C:\Users\你的用户名\AppData\Roaming\Google\AndroidStudio2023.3。这里面有IDE的索引、文件缓存、日志、局部历史记录等，虽然单看不算多大，一般一两个GB，但攒久了同样让人头疼。

除了这四个大头，还有一些零散缓存，比如IDEA插件缓存、系统临时文件，但相比之下优先级不高。我建议的迁移顺序是：SDK目录、Gradle用户目录、AVD镜像、Android Studio系统缓存。按空间收益从大到小排列，每一步都能快速见效。

1.2 迁移方案的核心思路：重定向而非复制粘贴

很多人的第一反应是“我直接把C盘的SDK文件夹剪切到D盘行不行”，这就是坑的起点。直接剪切文件夹有两个致命问题：第一，Android Studio和现有项目仍会按照旧路径查找文件，一旦找不到，整个IDE和构建系统会直接报错；第二，系统服务、PATH环境变量、项目配置文件里的路径全部指向旧位置，你不可能一个个手动改完。

正确的思路是“重定向”，也就是让Android Studio、Gradle和模拟器去新的路径找它们需要的东西，而不是让系统适应你手动移动后的目录。三步走：先新建目录放内容，再修改配置指定新路径，最后重启验证。理解了这一点，后面所有步骤都是顺着这个主线走的。

还有个技术细节值得说：Windows上还有一种“符号链接”方案，用mklink /D创建目录链接，把C盘的默认路径指向D盘实际目录。这个方案确实能做到“路径不变、物理位置变了”，但它的前提是你愿意维护链接关系，且对系统层操作更熟悉。对于常规开发场景，我更推荐直接修改配置，理由很简单：配置是Android Studio原生支持的机制，改完一劳永逸，不依赖系统的链接状态，也不会因为某些工具不识别链接而出问题。

2. SDK搬家：改一个路径全盘生效

2.1 在Android Studio里优雅地更换SDK目录

SDK目录的迁移，我把它定义为“最没有技术含量但收益最高”的一步，因为它完全不用碰文件，Android Studio自带了一个可视化迁移入口。

具体操作路径：打开Android Studio，进入Settings（Windows上是File菜单下的Settings），在左侧导航找到Languages & Frameworks，展开后点Android SDK。右边的界面第一栏写着Android SDK location，点旁边的Edit按钮（有些版本是三个点），Android Studio会弹出一个SDK设置向导，允许你重新指定一个全新的SDK目录。

这里有个很多人会犯的错误：点Edit之后，Android Studio会默认选中你当前的SDK目录，你要做的不是直接点Finish，而是先手动修改路径为你想要的新位置，比如D:\Android\Sdk。确认新路径后，向导会提示“这个目录是空的，需要下载哪些组件”，并列出当前安装的所有SDK平台、Build-Tools版本、System-Images。保持默认全选，点Next开始下载安装，这一步会把你原来SDK的所有组件在新路径下重新装一遍。

下载完成后，Settings界面顶部显示的路径就变成了新位置，Android Studio从此彻底切换到新SDK目录。等它下载同步结束，原有的SDK目录就可以放心的手动删除或者先留着观察一段时间。

你可能会问：这不就是重新下了一遍吗？跟复制剪切有什么区别？区别在于，Android Studio通过正规下载流程，会在新目录里生成完整的包管理元数据，后续SDK Manager的增量更新、版本识别、许可接受状态全都基于这个元数据工作。直接复制旧目录虽然文件都在，但偶尔会出现版本识别异常、许可状态丢失的问题。所以我的建议始终是：直接用Edit功能让SDK Manager自己在新位置“重建”，省心又干净。

2.2 手动迁移兼容老项目

SDK目录迁移完后，大部分事情就该正常了，但有一类场景需要额外处理：旧项目里指定了绝对SDK路径。Android项目里通常有一个local.properties文件，位于项目根目录，里面有一行sdk.dir=C:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk。这个路径一旦指向旧目录，项目构建就会报错“SDK location not found”。

怎么处理？最简单的方式是：打开项目根目录下的local.properties，把sdk.dir改成新的SDK路径，然后把反斜杠替换成双反斜杠或者用正斜杠，例如sdk.dir=D:\\Android\\Sdk。改完后重新Sync一下项目。

另外还有一种情况是环境变量。部分项目的构建脚本或命令行工具依赖ANDROID_HOME或ANDROID_SDK_ROOT环境变量，这两个变量可能在你装SDK的时候被写入过系统环境变量。我的建议是顺手把Windows环境变量也更新了：进入系统属性→高级→环境变量，找到ANDROID_HOME和ANDROID_SDK_ROOT（如果有），把它们的值都改成新SDK路径。没有设置过的话可以不设置，Android Studio和Gradle现在都能通过local.properties找到SDK。

这里插一条操作提醒：修改完环境变量后，要重启Android Studio和所有命令行窗口才生效，不要修改完就急着验证说“怎么没生效”。

2.3 SDK迁移容易踩的坑

SDK迁移这部分我遇到过几个比较典型的坑，单独列出来大家避一避：

• 新路径不能有中文和空格。SDK Manager虽然是Java开发的，但底层的构建工具和命令行工具对路径的解析能力参差不齐，个别工具（尤其老的NDK版本、CMake）遇到中文路径会直接失败。建议只使用字母和数字的绝对路径，比如D:\Android\Sdk。
• System-Images其实很大。有些同学迁移完SDK发现没释放多少空间，仔细一看，原来模拟器的系统镜像（system-images目录）占了大头。不用慌，SDK Manager在重建的时候也会把这些镜像重新下载到新目录，你只要在Edit向导里确认System-Images被勾选即可。
• 删除旧SDK目录前要确认三件事：新SDK能正常编译项目、模拟器能正常启动、SDK Manager能正常显示已安装组件。确认之后再去删，别急着一刀切。

3. Gradle用户目录迁移：最容易被忽视的空间黑洞

3.1 Gradle目录里到底装着什么

如果说SDK是明面的大户，那Gradle用户目录就是名副其实的“空间黑洞”，因为它藏得很深，而且很多开发者根本不知道它存在。

我们平常用Android Studio打开项目，Gradle会在后台下载依赖库、下载Gradle发行版，这些东西默认全部进入C:\Users\你的用户名\.gradle。这个目录的结构大致是这样的：

• .gradle\caches\modules-2\files-2.1：存放项目依赖的所有构件，jar包、aar包都在这里，按组名、模块名、版本号层层嵌套。项目的依赖越多，这个目录越大，几十GB不是梦。
• .gradle\wrapper\dists：存放Gradle Wrapper下载的各版本Gradle发行版。每个版本一个文件夹，里面有压缩包和解压后的完整运行目录。
• .gradle\caches\transforms-*：这是AAR转换后的中间产物，用于把AAR解包、处理资源并生成可用于编译的jar和资源。每次构建都会在这个目录里产出文件。
• .gradle\daemon：后台守护进程的相关目录，不算大。
• .gradle\jdks：部分较新的Gradle版本会在这里存放它自动下载的JDK。

这中间最要命的是caches和wrapper，它们加起来基本能占据Gradle目录的95%以上体积。很多项目从Git仓库拉下来后，第一次构建会下载数百MB依赖并缓存到Gradle目录里，这个缓存一旦积累下来，C盘空间就像流水一样没了。

3.2 GRADLE_USER_HOME环境变量的正确配置

迁移Gradle用户目录的官方机制是修改GRADLE_USER_HOME环境变量。Gradle在启动时会检查这个环境变量，如果设置了，它就把GRADLE_USER_HOME指向的目录当作自己的用户目录；如果没有设置，默认才是用户目录\.gradle。

具体的操作流程如下：

1. 关闭Android Studio和所有命令行中可能正在运行的Gradle进程，避免文件占用。
2. 在文件资源管理器中找到C:\Users\你的用户名\.gradle，把它完整复制到新位置，例如D:\Gradle\UserHome。复制之前先看一眼目录大小，如果是几十GB的大目录，复制时间会比较长，要有耐心。
3. 复制完成后进入Windows环境变量设置界面：右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。
4. 在“用户变量”区域点击“新建”，变量名填GRADLE_USER_HOME，变量值填你的目标路径，比如D:\Gradle\UserHome。注意别填到Gradle安装目录，它和Gradle发行版存放目录是两码事。
5. 点击确定保存，然后重新启动Android Studio。

重启后，Android Studio里的Settings→Build, Execution, Deployment→Build Tools→Gradle中，会多出一个Gradle user home设置项，你只需要确认它显示的是D:\Gradle\UserHome，就说明迁移成功了。

这里我想强调一下：一定要用复制，不要用剪切。原因很简单，如果复制后首次构建出现问题，你的原始数据还在C盘原地，随时可以恢复。等确认一切正常后，再去删除C盘的原.gradle目录，这不耽误你释放空间，但容错率高出不少。

3.3 迁移后的首次Sync注意事项

Gradle用户目录切换后，你第一次用Android Studio打开项目，它会进行一次完整的Gradle同步。这里有一个重要的点：不要看到它在重新下载依赖就觉得迁移失败了。Gradle的依赖解析机制是按缓存路径来的，路径变了之后，它需要重新扫描新目录里的缓存文件，但很多依赖它会认为“不在缓存里”，进而尝试从远程仓库下载。但实际上你提前把旧缓存内容完整复制过去了，所以下载过程通常很短，甚至只是本地路径重新解析。

不过，如果项目中用到了比较冷门的依赖、公司内部Maven仓库或特殊私有仓库，复制过去之后首次解析仍然可能会有网络访问，这个很正常。等待同步完成后，再到顶部的Build菜单跑一次Make Project，只要能正常编译通过，就说明Gradle缓存迁移成功了。

再补一个很常见的坑：GRADLE_USER_HOME路径同样不能有中文。之前帮同事排查过一个诡异问题：项目构建时Gradle莫名其妙报各种编码错误，后来发现他就是把Gradle缓存目录放在了D:\开发工具\gradle缓存，中文路径导致Gradle内部处理跨平台文件路径时出了问题。换成纯英文路径后一切正常。

4. AVD与Android Studio系统缓存：收掉最后的大块空间

4.1 模拟器镜像文件的迁移

AVD模拟器镜像存放在.android目录下，这个目录说实话很容易被忽略，因为大部分开发者平时看的是AVD Manager里的模拟器名字，不会去想它对应的镜像文件在物理磁盘的哪里。等到C盘告急时才猛然发现，光一个Pixel模拟器的系统镜像和用户数据文件就占了七八个GB。

迁移AVD的思路和SDK不太一样，它没有官方可视化入口，需要手动改配置。步骤如下：

1. 关闭Android Studio、关闭所有正在运行的模拟器进程，确保.android目录下的文件不是被占用状态。
2. 打开文件资源管理器，进入C:\Users\你的用户名\.android\avd目录。这个目录下有两类文件：一类是.ini文件，文件名就是你的虚拟设备名字，比如Pixel_4_API_30.ini；另一类是.avd结尾的文件夹，比如Pixel_4_API_30.avd，里面才是真正的镜像数据。
3. 将整个.android\avd目录完整复制到新位置，比如D:\Android\.android\avd。如果你只想迁移某几个AVD，也可以只复制对应的.ini和.avd文件夹。
4. 用文本编辑器打开复制过去的每个.ini文件，会看到类似这样的内容：

avd.ini.encoding=UTF-8 path=C:/Users/你的用户名/.android/avd/Pixel_4_API_30.avd path.rel=avd/Pixel_4_API_30.avd target=android-30

重点修改path这一行，把它改成新位置下的绝对路径，例如path=D:/Android/.android/avd/Pixel_4_API_30.avd。path.rel可以保留不管。

5. 保存后，重新打开Android Studio，进入AVD Manager，你会看到所有虚拟设备都还在，而且指向了新路径。

这里有个细节：.avd文件夹里的config.ini也可能包含指向旧路径的配置项，但一般不用管，因为模拟器启动时会优先读取.ini文件里的path字段来定位镜像目录。如果你的模拟器启动后报什么找不到SD卡或镜像文件，再检查一下.avd\config.ini里的相关路径，个别情况下需要一并改成新路径。

4.2 Android Studio系统缓存的idea.properties配置

这部分的迁移是四类里面操作门槛最高的，但说实话空间收益没有前几个大，我把它放到最后做。Android Studio自身会生成索引、本地历史、日志等系统文件，默认位置在C:\Users\你的用户名\.AndroidStudio2023.3。如果你已经做了前面三次迁移，C盘压力已经大幅缓解，这一步属于“锦上添花”。

Android Studio提供了一个官方支持的配置入口：修改安装目录下的bin\idea.properties文件。打开它，找到或添加下面这几行配置：

idea.system.path=D:/AndroidStudioCache/system idea.log.path=D:/AndroidStudioCache/log idea.config.path=D:/AndroidStudioCache/config

idea.system.path对应的是IDE的系统缓存目录，包括索引、临时文件、编译输出等。idea.log.path对应日志目录。idea.config.path对应配置目录，就是你的偏好设置、插件配置之类，一般不会太大，但如果你不想迁移它，可以不改。

三个路径都设置成新位置后，保存文件，重启Android Studio。首次启动时，IDE会在新路径下重建索引目录，这时界面可能显示正在加载索引，耐心等待几分钟即可。确认正常后，旧位置产生的缓存文件就可以清理掉了。

需要注意一点：idea.properties文件在不同版本的Android Studio中位置一样，但文件名可能不同，比如有些版本是idea.properties，有些版本在bin目录下还有studio64.exe.vmoptions这种JVM参数文件。你只需要关心idea.properties即可。

我实测下来，这个方案比用mklink符号链接要更稳，因为它是IDE原生支持的机制，不论是Windows还是macOS都通用，也不会出现某些临时文件被写回旧路径的情况。

4.3 隐藏的临时文件也要顺手清一清

完成上面四步迁移后，C盘还有几个零碎位置会持续增长，建议顺手处理一下：

• C:\Users\你的用户名\AppData\Local\Temp：Windows和Java程序写临时文件的地方，Android Studio和Gradle偶尔会在这落文件。可以直接进入目录手动清理，或者用磁盘清理工具跑一遍。
• C:\Users\你的用户名\AppData\Local\JetBrains：插件缓存、IDE升级缓存等，体积不大，但也可以清。
• C:\Users\你的用户名\.android里除了avd以外的其他内容：比如cache目录、模拟器运行临时文件，这些杂项加起来也有几百MB，看情况决定是否清理。

需要注意，清理临时文件时一定要确保没有正在运行的开发工具，否则会误删正在使用的文件，轻则进程报错，重则缓存损坏。

5. 迁移后的验证排错清单与我的实测经验

5.1 三步快速验证迁移是否成功

迁移做完不等于结束，你要花五分钟验证每个环节都真正生效，不然之后被一个隐蔽的路径问题折腾半天，就太冤了。我习惯用三步验证法：

第一步，验证SDK目录。打开Android Studio的Settings→Languages & Frameworks→Android SDK，看顶部的Android SDK location是否为D盘新路径。再打开任意一个项目的local.properties，确认sdk.dir指向新路径。

第二步，验证Gradle用户目录。打开Android Studio的Settings→Build, Execution, Deployment→Build Tools→Gradle，看Gradle user home是否为D盘新路径。然后在终端窗口运行一个简单命令检查当前会话里的环境变量，也可以直接输入echo %GRADLE_USER_HOME%，看输出是否为你设置的新路径。 注意，在图形界面设置完环境变量后，已经打开的终端窗口不会自动刷新，必须重新开一个终端再验证。

第三步，验证AVD。打开AVD Manager，检查每个虚拟设备是否存在，然后启动一个模拟器，确认能正常进入系统、系统设置里显示的存储空间正常。

如果你的旧SDK和Gradle缓存目录还在，这时的物理空间占用已经可以对比了：右键C盘查看剩余空间，你会明显看到可用空间涨了一大截。

5.2 常见问题与解决办法

迁移过程中我踩过的坑不少，把最常见的几个列出来，方便大家对号入座：

这些坑的共同点只有一个：路径没对上一一对应。迁移的本质就是让所有“查找文件”的动作都能指向新位置，所以说到底就是把SDK路径、Gradle用户路径、AVD路径、IDE缓存路径这四个信息维护好，其它问题基本迎刃而解。

5.3 我的一次完整迁移实测数据

按真实操作经验来看，一次完整迁移下来，C盘空间释放效果非常可观。我自己的机器是Windows 11，C盘原来占用187GB，可用空间只剩23GB，做完这套迁移后，C盘剩余空间直接涨到71GB。各目录占用情况如下：

• 原SDK目录：9.8GB
• 原Gradle用户目录：20.4GB
• 原AVD镜像目录：8.2GB
• 原Android Studio系统缓存目录：2.1GB

四部分加起来总共腾出了约40GB空间，等于把C盘从崩溃边缘拉了回来。最明显的变化是，原来每次Android Studio打开项目都要等好久的索引加载，现在因为系统缓存搬到了SSD较空闲的D盘分区，整体流畅度反而提升了一点——当然这个感受比较主观，但至少没有变慢。

如果有同学跟我最初一样，C盘可用空间已经小于5GB，连Android Studio都跑不动了，那还有一个应急办法：先把AVD镜像删除几个不常用的，瞬间能释放10GB以上；然后再去做完整迁移。永远不要让C盘空间影响到日常开发节奏，工具的稳定性在关键时刻比什么都重要。

最后再分享一个小技巧：上面这套迁移操作其实不只是针对Android Studio，你电脑上任何“默认往C盘塞东西”的开发工具，比如Python的pip缓存、npm的全局缓存、Docker的镜像目录，都可以用类似思路去重定向。一段时期检查一次C盘空间的增长趋势，在问题恶化之前就把它控制住，比事后再做“大扫除”舒服得多。