如何利用磁盘工具修复 macOS 中由于断电导致的逻辑卷组（LVM）元数据-Mac OS-PHP中文网

macos逻辑卷组元数据损坏需用终端命令修复：core storage问题执行diskutil cs unlockvolume/revert/delete；apfs容器问题执行diskutil apfs repaircontainer，二者均不恢复数据但可修复结构性错误。

macos 中没有传统 linux 风格的 lvm（logical volume manager），它使用的是 apple 自研的逻辑卷管理机制：core storage（cs）（macos 10.7–10.12）和 apfs 容器与卷宗（volume group）结构（macos 10.13+）。所谓“逻辑卷组元数据损坏”，实际指以下两类情形之一：

Core Storage 逻辑卷组（LVG）中断或损坏（常见于旧系统、FileVault 加密中途断电、Fusion Drive）
APFS 容器内卷宗配对异常或元数据错位（如 - Data 卷丢失绑定、快照链断裂、容器头校验失败）

磁盘工具的图形界面“急救”无法直接修复 LVG 或 APFS 容器级元数据——它只作用于已识别的宗卷（Volume）层级。必须用终端命令定向干预。

确认是否为 Core Storage 或 APFS 元数据问题

打开恢复模式（开机按 ⌘ + R），启动“终端”，依次执行：

diskutil list

若看到 Logical Volume Group、Logical Volume、Recovery Logical Volume 等字样 → 属于 Core Storage（旧系统）
若看到 Container、APFS Volume、Macintosh HD - Data 等 → 属于 APFS 容器结构

再运行对应诊断命令：

Core Storage：
```
diskutil cs list
```
关注 LVG Status（如 converting paused、corrupted、offline）和 LV Status（如 locked、unlocked）

APFS：

diskutil apfs list
diskutil verifyVolume /dev/diskXsY  # 替换为实际数据卷，如 disk1s5

若输出含 Invalid container header、Snapshot mismatch、Invalid checkpoint，说明是可修复的元数据逻辑错误。

针对 Core Storage 逻辑卷组（LVG）元数据修复

适用于 macOS 10.12 及更早、开启 FileVault 或使用 Fusion Drive 的设备。

尝试解锁并恢复加密状态

# 查看 LVG 和 LV 的 UUID
diskutil cs list

# 解锁逻辑卷（需输入密码或恢复密钥）
sudo diskutil cs unlockVolume LV_UUID

# 若卡在“正在加密”，尝试回滚
sudo diskutil cs revert LV_UUID

# 若 revert 失败，清除加密层（不删数据）
sudo diskutil cs delete LVG_UUID

✅ delete 操作仅移除 Core Storage 封装层，原始 HFS+/APFS 数据仍保留在物理分区中，之后可重新格式化或挂载。

macos-suite-readonly
macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。

下载

强制挂载裸分区（绕过 LVG）

若 cs list 显示 LVG 已损但底层分区仍存在（如 disk0s2）：

# 先卸载整盘
sudo diskutil unmountDisk /dev/disk0

# 尝试以原生文件系统挂载（HFS+ 或 APFS）
sudo diskutil mount -force /dev/disk0s2

成功后，可在访达中访问数据，再通过磁盘工具对其运行“急救”。

针对 APFS 容器元数据修复

适用于 macOS 10.13+，包括 Ventura、Sonoma、Sequoia 等。

修复容器结构（关键步骤）

APFS 容器头、区块映射表、快照索引等元数据损坏时，“急救”按钮常灰色不可点。此时需终端强制修复：

# 查看容器标识（如 disk1、disk2s1 的容器名是 “Container disk1”）
diskutil apfs list

# 验证容器完整性（只读）
diskutil apfs verifyContainer disk1

# 修复容器元数据（重写头、同步映射、清理坏块引用）
sudo diskutil apfs repairContainer disk1

⚠️ 此操作不修改任何用户文件内容，仅修正容器层面的逻辑结构，对断电导致的 block checksum mismatch、invalid superblock 等非常有效。

修复数据卷绑定异常（如 `- Data` 卷不显示）

APFS 中系统卷与数据卷靠 UUID 绑定。若绑定丢失，可尝试重建配对：

# 查看所有卷及其 UUID
diskutil apfs list

# 若发现 “Macintosh HD” 存在但 “Macintosh HD - Data” 缺失或离线：
# 先验证系统卷
diskutil verifyVolume "Macintosh HD"

# 再验证/修复数据卷（即使未挂载，只要分区存在即可）
sudo diskutil repairVolume "Macintosh HD - Data"

若提示 No such volume，说明数据卷元数据已损，但容器仍在，可考虑新建同名数据卷（需备份前提下谨慎操作）。