macos扩容失败多因apfs容器结构异常或宗卷空间锁死，而非物理损坏；需在恢复模式下依序修复数据宗卷、系统宗卷和容器本身，并清理快照、验证状态后手动扩容。
macos 扩容失败常被误判为“磁盘坏了”，其实多数情况是 apfs 容器结构异常或宗卷空间锁死，而非物理损坏。磁盘工具本身不能直接扩容，但它能修复阻碍扩容的关键底层问题——比如元数据错位、快照引用断裂、acl 权限越界等，让 diskutil apfs resizecontainer 命令重新生效。
确认是否真需“修复”而非“扩容”
先排除最常见误操作：
- 没进恢复模式就运行磁盘工具：启动宗卷（如 Macintosh HD）在正常系统下只能“验证”，不能“修复”。必须重启按 Command + R 进入恢复环境
- 选错了目标：要在磁盘工具左侧边栏点开“显示所有设备”后，找到最顶层的物理磁盘（如 APPLE SSD AP0512M Media），而不是直接点“Macintosh HD”
- 容器本身还有未分配空间：运行
diskutil apfs list查看容器 Size 是否等于硬盘总容量；若明显偏小（如 512GB 硬盘只显示 320GB 容器），说明空闲空间根本不在 APFS 管理范围内，此时应先用sudo diskutil apfs resizecontainer disk0s2 0扩容容器，而非修复
在恢复模式中正确执行三阶修复
进入恢复模式后，打开磁盘工具，严格按顺序操作：
- 第一步：修复数据宗卷 —— 先选中 Macintosh HD - Data（不是系统宗卷），点“急救”→“运行”。它负责用户文件和大部分缓存，修复后可释放被卡住的空间引用
- 第二步：修复系统宗卷 —— 再选同级的 Macintosh HD（标有“系统”字样），同样点“急救”。这一步清理日志索引、快照元数据和启动配置残留，解决“更新失败但空间明明够”的典型症状
- 第三步：修复容器本身 —— 返回边栏，选中包含两者的 APFS 容器（如 Container disk1），再点“急救”。这会校准容器内各宗卷的配额边界，防止后续 resize 报“APFS 容器损坏”
修复后必须做的验证动作
修复完成不代表扩容成功，还需手动确认状态是否就绪：
- 终端中运行
diskutil apfs list | grep -A 5 "Container"，检查容器 Size 和 Used 值是否合理，且没有 “Corrupted” 或 “Invalid” 标记 - 运行
tmutil listlocalsnapshots /，删除所有非com.apple.os.update开头的快照（例如sudo tmutil deletelocalsnapshots com.apple.TimeMachine.2026-04-25-091234），避免快照占用系统宗卷却无法释放 - 回到正常系统，打开“存储空间”→“管理”，强制触发一次缓存扫描，并点击“清空废纸篓”和“自动清除已下载内容”——这些动作会刷新空间统计，让系统重新识别可用容量
当磁盘工具提示“无法修复”时怎么办
这不是终点，而是明确信号：问题出在容器结构之外：
- 如果提示“该磁盘即将出现故障”，立即备份重要数据，更换硬盘。磁盘工具不处理硬件老化问题
- 如果提示“无法修复此宗卷”，但容器 Size 正常，大概率是本地快照或 Time Machine 缓存严重污染。尝试在恢复模式终端中运行：
sudo tmutil thinlocalsnapshots / 9999999999 1强制清理快照保留策略 - 仍失败？可考虑重建容器：备份数据 → 在磁盘工具中抹掉整个容器 → 重新安装 macOS。这不是重装系统，而是重置 APFS 结构，对 SSD 寿命无影响
