APFS空间报错主因是容器未占满物理盘或系统/数据宗卷挤兑，解决三步：确认容器是否吃满、平衡两宗卷占用、修复元数据一致性。
这类报错通常不是 apfs 容器真损坏，而是空间没“摊开”——容器本身没占满物理硬盘，或系统宗卷（macintosh hd）和数据宗卷（macintosh hd - data）之间严重挤兑。解决关键就三步：确认容器是否吃满、平衡两个宗卷的占用、修复元数据一致性。
先查容器有没有“剩饭”
打开终端，运行：
diskutil apfs list
找到你的主容器（比如 Container disk1），看它的 Size 是不是接近你硬盘标称容量（如 512GB SSD 显示 ~500GB）。如果明显偏小（比如只有 320GB），说明有几十 GB 空间被系统“看不见”，得先填上。
再补一句确认：
diskutil info disk0（把 disk0 换成你实际的物理盘号）
对比 Total Size 和上面容器的 Size，差值就是待释放的“失踪空间”。
用命令把容器扩到顶
只要硬盘物理空间还有余量，这一步是安全且必须的：
sudo diskutil apfs resizeContainer diskX 0
- 把 diskX 替换成你容器对应的标识符（比如 disk1s2 或 disk0s2，可从
diskutil list查） - 0 表示自动扩到最大可用空间，不是设为 0 字节
- 输完密码回车，等待完成（通常几十秒）
清理系统宗卷里的“占位符”
容器扩容后还报空间不足？大概率是系统宗卷被快照、缓存、日志塞爆了，而数据宗卷却空着。APFS 不会自动跨宗卷借空间：
- 进系统设置 → 通用 → 储存空间 → 管理，点开“缓存文件”“日志文件”“旧文件”逐项清理
- 终端运行 tmutil listlocalsnapshots /，删掉非
com.apple.os.update开头的旧快照：
sudo tmutil deletelocalsnapshots com.apple.TimeMachine.2026-04-28-101522 - 手动清 ~/Library/Caches 下大体积子目录（如 Safari、微信、Docker），但别删整个 Caches 文件夹；操作前确保对应 App 已完全退出（Command+Q）
进恢复模式做最终校准
重启按住 Command + R 进恢复模式 → 打开磁盘工具 → 左上角“显示 → 显示所有设备” → 先选中 Macintosh HD - Data（数据宗卷），点“急救”；再选中同容器下的 Macintosh HD（系统宗卷），同样点“急救”。这能修正因空间错配引发的 ACL 或快照引用异常。
不复杂但容易忽略
