诊断 macos 磁盘错误应聚焦内核层 i/o 故障事件，使用 log show 命令从统一日志提取 media error、timeout、stall 等结构化线索，优先筛选 appleahcidiskdriver、nvme 等子系统，并结合 shutdown cause 代码与错误码（如 0xe00002c7）定位硬件或驱动问题。
诊断 macos 磁盘错误，关键不是找“坏块”，而是抓取内核层真实发生的 i/o 故障事件——比如 media error、i/o timeout、disk i/o stall 这类由硬件或驱动触发的底层失败。log show 命令能直接从统一日志数据库中提取这些结构化线索，比图形界面更全、更及时。
聚焦磁盘相关子系统与驱动日志
macOS 把磁盘操作日志归入特定子系统，优先筛选这些路径才能避开应用层噪音：
- AppleAHCIDiskDriver：SATA 接口硬盘/SSD 的核心驱动
- IOAHCIBlockStorageDevice 或 NVMe：PCIe/NVMe SSD 的底层设备标识
- com.apple.driver.AppleSDXC：读卡器类外置存储
- com.apple.diskmanagement：卷挂载、格式化、校验等动作记录
执行命令定位最近 24 小时内所有磁盘驱动级错误：
log show --predicate 'subsystem == "com.apple.driver.AppleAHCIDiskDriver" || process == "kernel" && (eventMessage contains "error" OR eventMessage contains "timeout" OR eventMessage contains "stall" OR eventMessage contains "media")' --last 24h
匹配典型磁盘错误关键词与错误码
真正的磁盘 I/O 失败往往带明确术语或十六进制错误码，可直接用关键词过滤：
- "media error"：介质读写失败（如 NAND 单元失效）
- "I/O timeout" 或 "timeout"：设备无响应，常见于固件卡死或链路异常
- 错误码 0xe00002c7（I/O timeout）、0xe00002e2（media error）：内核返回的标准 I/O 故障码
- "disk I/O stall"：I/O 请求长时间挂起，可能指向固件或 PCIe 链路问题
精简检索示例（含错误码）：
log show --predicate 'eventMessage contains "media error" OR eventMessage contains "0xe00002e2" OR eventMessage contains "I/O timeout" OR eventMessage contains "0xe00002c7"' --last 7d
关联 shutdown cause 判断是否因磁盘故障导致崩溃
若磁盘严重错误引发 Kernel Panic 或强制关机，系统会在日志中留下 shutdown cause 代码。结合时间戳可反向验证：
- cause: 3 → 内核不可恢复错误（常由磁盘 I/O hang 触发）
- cause: 5 → 温度过高（SSD 过热降频也可能表现为 I/O 超时）
- cause: -128 → 用户手动关机（排除项）
批量提取并统计最近关机原因：
log show --predicate 'eventMessage contains "Previous shutdown cause"' --last 30d | grep "cause:" | sort | uniq -c | sort -nr
导出完整磁盘错误日志供深度分析
单次命令输出可能过长，建议导出为文本文件，方便逐行排查或发给技术支持：
- 保存最近 7 天所有磁盘相关错误（含 warning 级别，便于观察恶化趋势）：
log show --predicate '(subsystem contains "AppleAHCIDiskDriver" OR subsystem contains "NVMe" OR process == "kernel") AND (eventMessage contains "error" OR eventMessage contains "timeout" OR eventMessage contains "stall")' --last 7d > ~/Desktop/disk_errors.txt - 注意：--last 7d 不可写作 --last 7days，否则命令无效
