macos安装或升级失败时，应优先通过控制台app实时捕获installassistant、installd、softwareupdated进程的error/fault日志，重点关注“failed to copy”等报错；同时查看/var/log/install.log末尾记录，并在恢复模式下用log show命令提取installer、efi、amfi相关日志，结合shutdown cause和installererror代码精准定位故障根因。
macos系统安装或升级出问题时，日志是唯一能告诉你“卡在哪一步”“为什么失败”的直接证据。导出日志不等于复制全部文件，而是精准抓取与安装流程强相关的几类关键日志源——它们分散在不同位置、由不同进程生成，需用对应工具和命令提取。
用控制台App实时捕获安装过程中的异常
升级界面卡住、闪退或进度条不动时，别等重启后再查。只要Mac还能响应（比如时间仍在走、风扇有动静），立刻切换用户或启用远程登录，打开「控制台」：
- 按 Command + Space 搜索并打开「控制台」→ 左侧选本机名 → 点击顶部「开始流式传输」
- 在搜索栏输入：process: "InstallAssistant" OR process: "installd" OR process: "softwareupdated"，回车
- 再追加筛选条件：level: error OR level: fault，重点关注红色标记条目
- 留意含 "failed to copy"、"code signature invalid"、"permission denied on /System/Volumes/Update" 的报错——这些多出现在 Big Sur 及之后版本升级到 Sequoia 时，常因 SIP 或 APFS 快照权限异常引发
从终端导出结构化安装日志 install.log
/var/log/install.log 是 macOS 安装过程最权威的线性记录，每行带精确时间戳，记录从解包、校验、写入到重启的完整链条：
- 访达中按 Shift + Command + G，输入 /var/log/ 回车，找到 install.log
- 双击用「文本编辑」打开（部分条目需管理员权限）；更推荐终端查看末尾最新段：
sudo cat /var/log/install.log | tail -50 - 关键线索示例：
Jul 6 14:22:18 MacName installd[1234]: PackageKit: Install Started
Jul 6 14:28:03 MacName softwareupdated[567]: SoftwareUpdate: Completed OS update to 14.6 (23G125)
进恢复模式用 log show 抓取专属阶段日志
若已黑屏、无法进桌面，开机按住 Command + R 进入恢复模式，打开终端执行以下命令（必须在此环境下运行）：
- 查安装器全流程：log show --predicate 'subsystem == "com.apple.installer"' --last boot
- 查固件与驱动加载失败：log show --predicate '(subsystem contains "com.apple.efi" OR subsystem contains "com.apple.driver") AND (eventMessage contains "fail" OR eventMessage contains "reject")' --last boot
- 查权限与签名验证行为：log show --predicate 'eventMessage contains "amfi" OR eventMessage contains "tccutil"' --last 2h
- 如提示权限不足，先执行：csrutil authenticated-root disable（操作完记得重新启用）
配合 shutdown cause 和 InstallerError 代码定位根因
日志里藏着两个关键诊断字段，往往被忽略但极具指向性：
- shutdown cause：出现在系统异常关机或重启前的日志中，数字代码对应硬件或电源事件（如 3 表示内核 panic，5 表示温度过高）
- InstallerError：安装失败时 installer 进程抛出的错误码（如 1728 表示签名验证失败，1838 表示磁盘空间不足）
- 查这两个字段，比通读几百行日志更高效——它们直接指向故障层级：是固件？权限？磁盘？还是网络校验？
