删除 ~/.android/avd 会移除你 Mac 上的所有 Android 模拟器,连同每个模拟器里的应用、账号和快照。你的 Mac 无所谓,Android Studio 也能创建新设备,但旧设备里的数据不会回来。某个模拟器变大时,在 Android Studio 里擦除它的数据,或者只删除这一个设备,文件夹本身交给工具去管。
基本原则:还在用的设备擦除数据,不用的设备直接删除;只有 Android Studio 已经不再列出的设备,才手动去动这个文件夹。
快速回答
- 用
du -sh ~/.android/avd/*量一量。 - 用
~/Library/Android/sdk/emulator/emulator -list-avds列出设备。 - 还在用的设备擦除数据:Device Manager、Wipe Data。
- 不再需要的设备直接删除:Device Manager、Delete。
- 不用的系统镜像单独在 SDK Manager 里移除。
- 只手动删除残留,并且把
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 |
snapshots | Quick 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 里移除这些镜像。
常见问题
可以删除 ~/.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 文件夹组成。