APFS元数据损坏需按“数据宗卷→系统宗卷→容器→物理盘”四级顺序在恢复模式下逐层急救，跳过任一环节将导致修复不彻底；确认逻辑错误后必须进入恢复环境操作，失败时优先备份再考虑抹掉重建。
Mac断电后常出现宗卷无法挂载、访达不显示磁盘、提示“invalid volume header”或“snapshot mismatch”，这类问题本质是APFS文件系统元数据损坏，必须通过分层急救修复，不能跳过任一环节。
先确认是否为逻辑层错误
打开终端，执行 diskutil list。若能列出设备（如 disk2s1），但访达中不显示该宗卷，或在磁盘工具中呈灰色不可选，说明仍处于逻辑卷范畴；若 diskutil list 根本不显示该分区，则已超出本方案处理范围，需转向硬件诊断。
再运行 diskutil verifyVolume /dev/disk2s1（将 disk2s1 替换为实际标识符）。若输出含 “Invalid checkpoint”“corrupted extent record” 或 “snapshot mismatch”，就确认是断电引发的APFS逻辑层错误，可继续下一步。
进入macOS恢复环境启动急救
关机后立即按住 【Command + R】 开机，直到看到旋转地球或Apple标志才松手——这一步必须做，否则无法修复正在运行的启动宗卷。
进入恢复环境后，在实用工具窗口中选择“磁盘工具”，点击“继续”。
在磁盘工具顶部菜单栏，选取“显示”→“显示所有设备”，确保边栏完整呈现物理磁盘→容器→宗卷三级结构。
按顺序逐层运行急救
第一步：选中最底层的数据宗卷（通常是带 【- Data 后缀】 的那个，例如 Macintosh HD - Data），点按工具栏“急救”按钮 → 点“运行”。等待完成，记录结果提示。
第二步：向上选择它上方的系统宗卷（如 Macintosh HD），再次点“急救”→“运行”。这一步修复系统根目录与快照索引关联，跳过会导致后续挂载失败。
第三步：再向上选择该宗卷所属的容器（如 Container disk4），点“急救”→“运行”。容器层损坏会使多个宗卷同时不可见，必须在此阶段修复。
第四步：最后选中最顶层物理设备（如 APPLE SSD AP0512M），点“急救”→“运行”。这一步校验分区表与固件通信状态，防止因底层异常导致上层反复出错。
四步顺序不可调换——宗卷依赖容器状态，容器依赖物理磁盘分区表完整。任意一步提示“已修复”，都必须完成后续步骤才能确保稳定。
终端辅助验证与强制挂载（仅当图形界面卡住时）
方法一：在恢复环境的“终端”中，用 diskutil list 确认设备标识符，再执行 diskutil mount -force /dev/disk2s1。这能唤醒被锁死的宗卷，使其在磁盘工具中变为可操作状态。
方法二：若急救失败且日志显示 “file system is locked”，不要反复点击“运行”。立即改用命令行验证：diskutil apfs verifyVolume /dev/disk2s5（数据宗卷）和 diskutil apfs verifyVolume /dev/disk2s1（系统宗卷）。仅当 verifyVolume 明确报错时，才执行 repairVolume。
注意：repairVolume 命令具有不可逆性，【仅在 verifyVolume 输出具体错误码且GUI急救连续两次失败后才可使用】。
急救失败后的关键动作
如果对同一宗卷连续三次运行“急救”均提示“无法修复此宗卷”，立即停止操作。
在终端中运行 smartctl -a /dev/disk2（需先 brew install smartmontools）检查S.M.A.R.T.状态。若显示 “FAILING_NOW” 或 “Pre-fail”，说明硬盘即将故障，【必须立刻备份并更换硬件】。
若S.M.A.R.T.正常但急救仍失败，可尝试抹掉重建：在磁盘工具中选中该物理设备 → 点“抹掉” → 方案选“GUID分区图” → 格式选“APFS” → 输入名称 → 点“抹掉”。此操作将清除全部数据，不可恢复。
