Mac Docker报“no space left on device”主因是APFS容器未填满物理磁盘或系统宗卷被快照/缓存占满；需先用diskutil apfs resizeContainer diskX 0扩容容器，再清理Time Machine本地快照、Docker缓存，并在恢复模式下用磁盘工具修复Macintosh HD及Data宗卷。
mac 上 docker 或其他本地容器工具报错（如“no space left on device”“failed to create overlay mount”），常不是硬盘真满了，而是 apfs 容器内系统宗卷（macintosh hd）和数据宗卷（macintosh hd - data）之间空间分配失衡——系统宗卷被日志、快照、缓存占满，而数据宗卷仍有大量空闲，但容器无法自动跨宗卷调度。这类问题不损坏文件，却会阻断镜像拉取、构建甚至容器启动。
先确认容器是否吃满物理磁盘
APFS 容器若未占满整块 SSD，剩余空间就“不可见、不可用”，这是最常见却被忽略的根源：
- 打开终端，运行 diskutil apfs list，找到主容器（通常为 Container disk1），查看其 Size 值
- 对比你的 SSD 标称容量（如 512GB 实际约 499GB），若容器 Size 明显偏小（例如只有 320GB），说明有近 180GB 处于“未分配”状态
- 再运行 diskutil info disk0（将 disk0 换成你实际的物理盘编号），核对 Total Size 和容器 Size 的差值
用终端命令扩容容器至物理上限
只要硬盘健康、容器未损坏，就能安全扩容。这一步是后续所有操作的前提：
- 执行 sudo diskutil apfs resizeContainer diskX 0（X 替换为你的容器所在物理盘编号，如 disk0）
- 命令中 0 表示“填满所有可用物理空间”，系统会自动计算并扩展容器边界
- 完成后再次运行 diskutil apfs list，确认容器 Size 已与物理盘总容量一致
清理系统宗卷的无效占用
容器扩容后仍报空间不足？大概率是系统宗卷（Macintosh HD）被本地快照、缓存、日志塞满，而 Docker 镜像默认写入 /var/lib/docker，该路径实际挂载在系统宗卷上：
- 打开系统设置 → 通用 → 储存空间，等待扫描完成，点击“管理”，重点清理：缓存文件、日志文件、旧的 iOS 备份
- 终端运行 tmutil listlocalsnapshots / 查看本地快照；删除非系统更新类快照，例如：
sudo tmutil deletelocalsnapshots com.apple.TimeMachine.2026-04-15-092341 - 确保 Docker Desktop 已完全退出（右键菜单选 Quit），再手动清空：
rm -rf ~/Library/Caches/com.docker.docker 和 rm -rf ~/Library/Containers/com.docker.docker
用恢复模式修复宗卷结构一致性
空间分配长期失衡可能引发元数据错位（如 ACL 权限异常、快照引用断裂），导致系统误判可用空间。此时需在隔离环境下修复：
- 重启 Mac，按住 Command + R 进入恢复模式
- 打开“磁盘工具”，顶部菜单选 显示 → 显示所有设备
- 在边栏中依次选中：
→ Macintosh HD - Data → 点“急救”→“运行”
→ 同级的 Macintosh HD → 再点“急救”→“运行”
→ 最后选中顶层的 容器（Container disk1） → 运行一次“急救”
做完这四步，Docker 等容器工具基本能恢复正常拉取、构建和运行。关键不在删多少文件，而在让 APFS 容器和宗卷回归合理配比——系统宗卷留出 10–15GB 安全余量，其余空间由数据宗卷承载用户数据与容器工作负载。
