在 macOS 恢复模式中可通过终端运行 log 命令查看安装日志，包括最近2小时 Installer 相关日志、本次启动后的 osinstall/diskmanagementd 日志及错误信息，升级失败后需回正常系统检查 /var/log/install.log 等补全日志。
在 macOS 恢复模式中，图形界面不显示安装或升级过程的实时日志，但系统底层仍在持续记录。你无法像日常使用那样打开“控制台”App，但可以通过恢复环境中的终端，调用 log 命令读取已写入的日志数据——这些日志多数是在重启进入恢复环境前、或升级启动初期生成的。
进入恢复模式并打开终端
- Apple Silicon Mac：关机后长按电源键，出现启动选项 → 选“选项” → 点“继续” → 输入管理员密码（如有）
-
Intel Mac：关机后按住
Command + R开机，直到看到苹果图标或旋转地球 - 进入恢复界面后，顶部菜单栏选择「实用工具」→「终端」
在恢复终端中查看关键日志
恢复环境下的日志服务仍在运行，只是不对外暴露图形界面。你可以用 log show 提取与安装、启动、磁盘操作相关的结构化日志：
-
查看最近 2 小时内与安装器相关的日志：
log show --predicate 'subsystem contains "Installer" OR process == "osinstallersetup"' --last 2h
-
查看从本次启动（即进入恢复环境）开始的所有 installer 和系统初始化日志：
log show --predicate 'subsystem contains "osinstall" OR subsystem contains "diskmanagementd" OR process == "bootpd"' --last boot
-
若升级卡在某个环节（如验证失败、分区异常），可重点筛选错误级别日志：
log show --predicate 'eventMessage contains "fail" OR eventMessage contains "error"' --last 1h --level error
注意：部分日志（尤其是最后阶段）可能尚未写入恢复环境的统一日志数据库，需等升级失败后重启回正常系统，再检查
/var/log/install.log和/var/log/system.log补全记录。
升级失败后回正常系统补查日志
一旦重启回到桌面，以下文件和命令能帮你收尾分析：
-
直接查看安装主日志：
cat /var/log/install.log | tail -n 50
-
结合系统日志定位配套服务异常：
log show --predicate 'process == "osinstall" OR process == "diskmanagementd"' --last 24h | grep -i "fail\|error\|abort"
-
快速导出全部安装相关日志到桌面便于分享：
log show --predicate 'subsystem contains "osinstall"' --last 7d > ~/Desktop/osinstall_full.log
小提示：别忽略预检日志
真正的问题往往出现在升级启动前。进恢复模式前，可在原系统中提前检查：
- 待安装更新是否就绪：
softwareupdate --list - 下载与校验状态：
softwareupdate --dump-state - 预安装准备记录：
tail -30 /var/log/install.log
这些信息常包含磁盘空间不足、签名验证失败、固件不兼容等明确原因，比盲等恢复模式日志更高效。
不复杂但容易忽略
