答案是先确认APFS容器是否占满物理磁盘，再清理系统宗卷快照缓存、管理Docker.raw虚拟磁盘并修复宗卷结构。具体需运行diskutil apfs list查容器Size，用sudo diskutil apfs resizeContainer disk0 0扩容；删非系统快照、清理缓存；执行docker system prune -a --volumes；最后在恢复模式用磁盘工具依次急救数据宗卷、容器和物理盘。
macos 中 docker 等容器化引擎报错（如启动失败、镜像拉取卡住、提示“no space left on device”），常不是硬盘真满了，而是 apfs 容器内空间分配失衡——系统宗卷被快照和缓存撑爆，数据宗卷却空闲；或 docker.raw 虚拟磁盘所在容器本身没吃满物理磁盘，导致可用空间“看得到用不上”。解决要分两层：先理清容器结构，再清理/释放 docker 专用空间。
确认 APFS 容器是否占满物理磁盘
这是最常被跳过的一步。Docker.raw 文件存放在 /System/Volumes/Data 下（即 Macintosh HD - Data 宗卷），而该宗卷属于一个 APFS 容器。如果容器本身只占了硬盘的一部分，Docker 就无法突破这个上限，哪怕物理盘还有上百 GB 空闲。
- 打开终端，运行：diskutil apfs list，找到主容器（通常为 Container disk1），检查其 Size 是否接近你硬盘的标称容量（如 512GB SSD 应显示约 499GB）
- 若明显偏小（比如只有 320GB），再运行：diskutil info disk0（把 disk0 换成你实际的物理盘编号），对比 Total Size 和容器 Size 的差值——这就是“失踪空间”
- 补上它：sudo diskutil apfs resizeContainer disk0 0（0 表示自动填满所有未分配空间）
清理系统宗卷中霸占空间的本地快照与缓存
Docker 报错常发生在系统更新或大镜像拉取时，此时 macOS 会临时占用大量系统宗卷（Macintosh HD）空间。但快照和日志不释放，Docker 就会被“误伤”。
- 查本地快照：tmutil listlocalsnapshots / 或 diskutil apfs listSnapshots /System/Volumes/Data
- 删掉非系统更新类快照（避开以 com.apple.os.update 开头的）：sudo tmutil deletelocalsnapshots com.apple.TimeMachine.2026-04-15-102345
- 进系统设置 → 通用 → 储存空间 → 管理，重点清理“缓存文件”“日志文件”，并开启“优化储存空间”
- 退出 Safari、微信、VS Code 等常驻后台的大内存 App，再手动清 ~/Library/Caches 下对应子目录（别删整个 Caches）
直接管理 Docker.raw 虚拟磁盘
Docker Desktop 在 macOS 上通过 HyperKit 运行 Linux 虚拟机，所有镜像、容器、卷都存在 ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw 这个单一大文件里。它默认动态扩展，但上限 64GB，且不会自动收缩。
- 查当前大小：du -sh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw
- 安全清理（保留配置）：docker system prune -a --volumes（删无用镜像、容器、卷）
- 若仍超限，可重置 Docker Desktop：Docker Desktop → Preferences → Troubleshoot → Reset to factory defaults（⚠️会清空所有镜像和容器）
- 如需扩容（比如从 64GB 到 100GB）：先退出 Docker Desktop，再用 qemu-img（需提前安装）：qemu-img resize ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw 100G
修复容器与宗卷结构一致性
空间分配长期失衡可能引发元数据错位，例如快照引用异常或 ACL 权限跨宗卷失效，导致系统统计出错，Docker 启动时读取失败。
- 重启按 Command + R 进恢复模式
- 打开磁盘工具 → 查看 → 显示所有设备
- 依次对以下三项运行“急救”：Macintosh HD - Data 宗卷 → 对应的 APFS 容器 → 物理盘（如 disk0）
- 每步完成后等提示“已完成”，再进行下一步；若某步提示已修复错误，重启后重试 Docker
