返回博客

Mac 上的 ~/.android/avd 文件夹可以删除吗

~/.android/avd 里装了什么,哪个文件让 Android 模拟器变大,删掉它会失去什么,以及如何改为擦除数据或只删除某个虚拟设备。

已发表 2026年10月25日 作者 Vladimir Chemeris 阅读时间 约 1 分钟阅读
Android模拟器Developer Cleanup

删除 ~/.android/avd 会移除你 Mac 上的所有 Android 模拟器,连同每个模拟器里的应用、账号和快照。你的 Mac 无所谓,Android Studio 也能创建新设备,但旧设备里的数据不会回来。某个模拟器变大时,在 Android Studio 里擦除它的数据,或者只删除这一个设备,文件夹本身交给工具去管。

基本原则:还在用的设备擦除数据,不用的设备直接删除;只有 Android Studio 已经不再列出的设备,才手动去动这个文件夹。

快速回答

  1. 用 du -sh ~/.android/avd/* 量一量。
  2. 用 ~/Library/Android/sdk/emulator/emulator -list-avds 列出设备。
  3. 还在用的设备擦除数据:Device Manager、Wipe Data。
  4. 不再需要的设备直接删除:Device Manager、Delete。
  5. 不用的系统镜像单独在 SDK Manager 里移除。
  6. 只手动删除残留,并且把 NAME.avd 和 NAME.ini 一起删掉。

~/.android/avd 里有什么

每个虚拟设备由两项组成:一个 NAME.ini 文件,以及它指向的 NAME.avd 文件夹。我在 2026 年 10 月 25 日量了自己的这个文件夹。里面只有一个设备,是基于 API 37、带 Google Play 镜像的 Medium Phone 配置,共占 2.8 GB:

NAME.avd 内存放内容在我的 Mac 上
userdata-qemu.img.qcow2数据分区:已安装的应用、应用数据、账号2.2 GB
sdcard.img模拟的 SD 卡512 MB
encryptionkey.img 和 .qcow2设备的加密密钥镜像94 MB
snapshotsQuick Boot 快照,在模拟器保存快照时才有无
config.ini硬件配置以及系统镜像的路径几 KB

数据分区会随着你安装和使用应用而增长。这个设备的 config.ini 设置了 disk.dataPartition.size=10G,所以单这一个文件就能长到 10 GB。

这个文件夹里没有什么

Android 系统本身在 SDK 里,而不在 AVD 文件夹里。config.ini 用类似 image.sysdir.1=system-images/android-37.0/google_apis_playstore/arm64-v8a/ 这样的一行指向它。在我的 Mac 上,~/Library/Android/sdk/system-images 另外占了 2.7 GB,模拟器二进制文件占 1.2 GB,NDK 占 2.1 GB。

这种分离带来两个后果:

  • 删除设备不会释放它的系统镜像。多个设备可以共用一个镜像。
  • 删除系统镜像后,使用它的设备将无法启动,直到你重新安装该镜像。

Android Studio 的 SDK Manager 会列出已安装的镜像,并可以移除你不需要的那些。

擦除数据还是删除

Wipe Data 会把设备恢复到出厂状态,同时保留它的定义。数据分区会缩回去,之后你要重新登录、重新安装测试应用。在 Device Manager 里,它位于设备的菜单中。在终端里,则是带上这个参数启动一次设备:

~/Library/Android/sdk/emulator/emulator -avd Medium_Phone_API_37.0 -wipe-data

模拟器的帮助把 -wipe-data 描述为“reset the user data image (copy it from initdata)”(重置用户数据镜像,从 initdata 复制)。

Delete 会删除设备及其文件。适用于那些为一次测试而创建、之后就被遗忘的设备。

快照在 Quick Boot 保存了较大的状态时才值得关注。用 -no-snapshot-save 启动的模拟器在退出时不会保存快照,而设备的 snapshots 文件夹能让你看到之前的会话留下了什么。

手动删除

手动删除适用于残留:来自已经被你卸载的 Android Studio 的设备,或者指向已删除系统镜像的设备。NAME.avd 文件夹和对应的 NAME.ini 文件要一起删,因为 .ini 文件存在的唯一目的就是指向那个文件夹。

不要顺手把整个 ~/.android 文件夹也清掉。它还存放着:

  • debug.keystore,为你的调试构建签名的密钥。新生成的密钥指纹也是新的,所以限定为旧调试 SHA-1 的 API 密钥会对调试构建失效。
  • adbkey,你的实体测试设备为 USB 调试授权过的密钥。它一变,设备就会再次请求授权。

总结

删除 ~/.android/avd 不会弄坏你 Mac 上的任何东西,但会带走你所有的模拟器及其数据。先量一量文件夹,要保留的设备擦除数据,不要的设备直接删除;等用到某些系统镜像的设备都没了,再去 SDK Manager 里移除这些镜像。

关于作者

Vladimir Chemeris

StorageRadar 创始人

Vladimir Chemeris 开发 StorageRadar,一款注重隐私的 macOS 存储分析应用,强调先审查后清理、开发者存储和前后对比。

常见问题

可以删除 ~/.android/avd 吗?

对你的 Mac 来说是安全的,对你的模拟器来说则无法挽回。每个虚拟设备都会消失,连同里面安装的应用、账号和快照。Android Studio 可以创建新设备,但旧设备里的数据不会回来。

删除 AVD 会删掉 Android 系统镜像吗?

不会。系统镜像位于 SDK 文件夹中,默认是 ~/Library/Android/sdk/system-images,每个设备的 config.ini 只是指向其中一个。系统镜像要在 Android Studio 的 SDK Manager 里移除。

如何在不删除模拟器的情况下缩小它?

擦除它的数据。在 Android Studio 的 Device Manager 里为该设备选择 Wipe Data,或者用 emulator -avd NAME -wipe-data 启动一次。设备会保留它的定义,启动后就像一部新手机。

可以删除整个 ~/.android 文件夹吗?

不要全删。除了 avd,它还存放着 debug.keystore,也就是为你的调试构建签名的密钥;以及 adbkey,你的实体测试设备授权过的就是它。Android Studio 会创建新的,但设备会再次要求授权,限定为旧调试指纹的 API 密钥也会失效。

Android Studio 把模拟器存在 Mac 的什么位置?

在 ~/.android/avd 里,除非 ANDROID_AVD_HOME 环境变量指向了别处。每个设备由一个 NAME.ini 文件和一个 NAME.avd 文件夹组成。

来源和参考文献

把你的模拟器和其他开发者存储放在一起看。

StorageRadar 的 Dev Cleanup 并排显示 Android 模拟器数据、Gradle 缓存、Xcode 文件夹和各个包缓存的大小,按风险给每一项打上标签,并带你对有风险的配置走完 Dry Run 和 Guided Preflight。