Android Studio

Android Studio / Gradle / 模拟器镜像:Android 开发三大占用源

Android 开发会在 Gradle 缓存、SDK 目录和模拟器镜像三处持续累积数据,常常成为 macOS 上最容易被忽略的大体积来源。

更新于:

阅读时长: 7 分钟

为什么会悄悄变大

Gradle 会缓存依赖图,SDK 目录会保留多版本构建工具和平台,单个模拟器镜像也可能达到数 GB。若团队要兼容多个 API 等级和机型,体积增长会非常快。

Free Mac Space 如何定位

Free Mac Space 会重点展示 ~/.gradle/caches、~/.android、~/Library/Android/sdk 以及 ~/Library/Caches/Google、~/Library/Application Support/Google 下的 Android Studio 相关目录,让你快速定位主占用层。

Free Mac Space 如何帮助清理

建议先审查后清理:优先处理过大的 Gradle 缓存与陈旧模拟器镜像,再确认哪些 SDK 版本仍被当前项目或 CI 使用。

安全边界

误删 SDK 或模拟器文件可能导致构建失败。删除前应保留当前发布分支和 CI 所需版本,避免影响在产流程。

Free Mac Space 扫描路径

  • ~/.gradle/caches
  • ~/.android
  • ~/Library/Android/sdk
  • ~/Library/Caches/Google/AndroidStudio*
  • ~/Library/Application Support/Google/AndroidStudio*

建议的月度检查步骤

  • 在依赖大升级后优先清理陈旧 Gradle 缓存。
  • 淘汰不再测试的 API 等级与模拟器镜像。
  • 验证构建通过后导出报告,作为团队基线记录。

操作步骤(HowTo)

  1. 1. 识别 Android Studio 的增长来源

    Gradle 会缓存依赖图,SDK 目录会保留多版本构建工具和平台,单个模拟器镜像也可能达到数 GB。若团队要兼容多个 API 等级和机型,体积增长会非常快。

  2. 2. 确认扫描覆盖路径

    Free Mac Space 会重点展示 ~/.gradle/caches、~/.android、~/Library/Android/sdk 以及 ~/Library/Caches/Google、~/Library/Application Support/Google 下的 Android Studio 相关目录,让你快速定位主占用层。 重点路径:~/.gradle/caches、~/.android、~/Library/Android/sdk、~/Library/Caches/Google/AndroidStudio*、~/Library/Application Support/Google/AndroidStudio*。

  3. 3. 先看安全边界再执行动作

    误删 SDK 或模拟器文件可能导致构建失败。删除前应保留当前发布分支和 CI 所需版本,避免影响在产流程。

  4. 4. 按先审查后清理流程执行

    建议先审查后清理:优先处理过大的 Gradle 缓存与陈旧模拟器镜像,再确认哪些 SDK 版本仍被当前项目或 CI 使用。

  5. 5. 复核动作 1

    在依赖大升级后优先清理陈旧 Gradle 缓存。

  6. 6. 复核动作 2

    淘汰不再测试的 API 等级与模拟器镜像。

  7. 7. 复核动作 3

    验证构建通过后导出报告,作为团队基线记录。

常见问题

  • Android Studio 这类占用通常来自哪里?

    主要来源包括:Gradle 依赖缓存、Android SDK 组件、AVD 模拟器磁盘镜像。Gradle 会缓存依赖图,SDK 目录会保留多版本构建工具和平台,单个模拟器镜像也可能达到数 GB。若团队要兼容多个 API 等级和机型,体积增长会非常快。

  • 这篇文章建议重点查看哪些路径?

    建议优先检查这些路径:~/.gradle/caches、~/.android、~/Library/Android/sdk、~/Library/Caches/Google/AndroidStudio*、~/Library/Application Support/Google/AndroidStudio*。Free Mac Space 会重点展示 ~/.gradle/caches、~/.android、~/Library/Android/sdk 以及 ~/Library/Caches/Google、~/Library/Application Support/Google 下的 Android Studio 相关目录,让你快速定位主占用层。

  • 如何在不增加误删风险的前提下处理?

    建议先审查后清理:优先处理过大的 Gradle 缓存与陈旧模拟器镜像,再确认哪些 SDK 版本仍被当前项目或 CI 使用。 误删 SDK 或模拟器文件可能导致构建失败。删除前应保留当前发布分支和 CI 所需版本,避免影响在产流程。

  • 月度复查时应该怎么执行?

    在依赖大升级后优先清理陈旧 Gradle 缓存。;淘汰不再测试的 API 等级与模拟器镜像。;验证构建通过后导出报告,作为团队基线记录。

继续执行对应方案

如果你已完成阅读,可直接进入「npm / pnpm / Yarn / Bun 缓存清理」按步骤执行。

查看对应场景方案

更多隐蔽占用案例

Xcode

Xcode 的 DerivedData 和 DeviceSupport:最常见的隐藏巨头

Xcode 会在构建产物和模拟器/设备支持文件里悄悄累积几十 GB。本文讲清楚它为什么膨胀,以及如何在不影响当前项目的前提下清理。

阅读文章

Docker

Docker Desktop 虚拟磁盘:项目结束了,空间却还在涨

Docker 镜像层、构建缓存和 VM 磁盘文件都在受管目录中,平时不容易在 Finder 里看清楚,但体积会增长得很快。

阅读文章

Homebrew

Homebrew 缓存目录:安装很快,历史缓存更快变大

Homebrew 会保留下载包和元数据缓存,版本升级后仍可能长期存在,是非常典型的“看不见但可安全处理”的空间来源。

阅读文章