macOS升级失败后应通过控制台筛选level: error并追加process: installd或subsystem: com.apple.installer锁定安装错误，终端执行log show命令导出安装日志，再从“报告”中查看shutdown cause代码（如3表示内核不可恢复错误），同时关注磁盘空间不足或签名验证失败等典型日志特征。
macOS 升级安装失败后，日志是判断卡点在哪的最直接依据。关键不是翻遍所有记录，而是快速锁定与安装过程强相关的错误线索——尤其是那些在重启前后集中爆发、带明确错误代码或进程名的日志条目。
用“控制台”抓取安装失败现场日志
系统重启后打开“控制台”，左侧选中本机，顶部搜索栏直接输入：
● level: error —— 筛出全部错误级别条目
● 再追加 process: installd 或 subsystem: com.apple.installer —— 聚焦安装服务本身
● 若看到红色 fault 条目（如“Failed to mount package”“Could not verify signature”），基本就是安装中断的直接原因
终端命令提取完整安装周期日志
图形界面可能漏掉早期错误，终端能调取更全记录：
● 打开终端，运行：
log show --predicate 'subsystem contains "com.apple.installer" OR process == "installd" OR eventMessage contains "install"' --last boot > ~/Desktop/install_errors.txt
● 该命令导出从上次启动至今所有安装相关日志到桌面文件，方便逐行排查
● 特别注意含 “code”, “failed”, “denied”, “not found”, “signature” 的行
查“报告”里的关机诊断文件
升级失败常伴随强制重启或内核恐慌，系统会自动生成诊断快照：
● 在“控制台”左侧点击“报告”
● 找最新一条含 shutdown 或 panic 字样的 .diag 文件
● 双击打开，滚动到底部找 Previous shutdown cause
● 常见值：3 表示内核不可恢复错误；5 表示因温度过高强制关机；0 表示正常关机（说明失败发生在重启后）
检查磁盘与签名验证类错误
两类高频问题对应固定日志特征：
● 磁盘空间不足：日志中出现 “No space left on device” 或 “NSCocoaErrorDomain Code=640”
● 签名验证失败：含 “code object is not signed at all”、“invalid signature”、“notarization”、“hardened runtime” 等关键词
● 这类错误往往指向安装器损坏、系统时间异常或 Gatekeeper 策略冲突，需重新下载安装器并校准系统时间
