“卷宗层级损坏”指APFS中卷或容器元数据异常，需在恢复模式下按卷→容器→物理设备顺序用磁盘工具急救，辅以终端强制挂载或加密解锁操作。
“卷宗层级损坏”通常指 apfs 文件系统中宗卷（volume）或容器（container）的元数据异常，比如 b-tree 错误、快照链断裂、acl 混乱或权限错位——这类问题常见于外置硬盘意外断电、强制拔出或 macos 异常关机后。磁盘工具的“急救”功能可针对性修复，但需严格按层级顺序操作，且必须在恢复模式下进行。
先确认是否属于可修复的卷宗层级错误
外置硬盘出现“卷宗层级损坏”提示时，先观察以下特征：
- 硬盘能被系统识别（在“磁盘工具”边栏中可见，或终端执行 diskutil list 能列出 diskXsY 设备）
- 宗卷名称显示但呈灰色、无法选中“急救”，或挂载失败并报错如 “invalid volume header”、“snapshot mismatch”、“Invalid checkpoint”
- 运行 diskutil verifyVolume /dev/diskXsY 返回具体文件系统级错误，而非 “device not found” 或 “no such device”
- 物理设备无异响、不发热、连接稳定，且在其他 Mac 上表现一致
满足以上，说明问题仍在逻辑卷/容器层，磁盘工具可介入；若连设备都未识别，或 diskutil list 完全缺失该盘，则已超出卷宗范畴，需排查 USB 控制器、线缆、供电或硬件故障。
在恢复模式下逐级运行急救（关键步骤）
外置硬盘虽非启动盘，但为避免系统占用和锁死状态，仍建议进入恢复模式操作：
- 关机后按住 ⌘ + R 开机，进入 macOS 恢复环境
- 打开“磁盘工具” → 点击顶部菜单“显示” → 选择“显示所有设备”
- 在边栏中找到你的外置硬盘，展开后识别三级结构：物理设备（如 WD My Book）→ 容器（Container diskX）→ 宗卷（如 Backup - Data）
- 先选中最末级的宗卷（带 - Data 后缀的通常是主数据宗卷），点击“急救”→“运行”
- 成功后，再选中它上方的容器，再次运行“急救”
- 最后选中最顶层的物理设备条目，对整块外置盘做一次底层结构校验
这个顺序不能跳过或颠倒：宗卷修复依赖容器状态正常，容器修复又以分区表完整为前提。
终端辅助诊断与强制唤醒（当图形界面卡住时）
如果磁盘工具里宗卷显示但“急救”按钮灰色，或提示“file system is locked”，可尝试终端干预：
- 在恢复模式中打开“终端”，执行 diskutil list 确认设备标识（如 /dev/disk3s2）
- 运行 diskutil verifyVolume /dev/disk3s2 查看具体报错类型
- 若提示 locked，试 diskutil mount -force /dev/disk3s2 强制挂载
- 挂载成功后，回到磁盘工具重新选中该宗卷运行“急救”
- 若始终无法挂载或验证报 “Could not verify volume”，说明元数据已严重损毁，不宜反复急救
加密卷或 FileVault 中断的特别处理
外置硬盘若启用了加密（尤其是使用 FileVault 或磁盘工具加密），断电可能导致加密状态卡在 converting paused 或 locked：
- 在终端运行 diskutil cs list 或 diskutil apfs list（APFS 下）找出对应卷的 UUID
- 尝试 diskutil apfs unlockVolume UUID（APFS 加密）或 diskutil cs unlockVolume UUID（CoreStorage）并输入密码
- 解锁失败时，可考虑 diskutil apfs decryptVolume UUID 回退加密（不删数据），或 diskutil apfs deleteVolume UUID 清除加密层（仅删元数据）
完成上述任一操作后，再回到磁盘工具对宗卷执行“急救”。
