macos升级日志需分阶段获取：升级前查softwareupdate状态和/var/log/install.log；升级中在恢复环境用log show捕获；升级后检查install.log、system.log及console中osinstall相关记录。
macOS 系统升级安装过程中的日志无法通过常规图形界面实时查看，因为升级（尤其是大版本如 macOS Sequoia）会重启进入恢复环境，此时标准日志服务暂停。但升级前、中、后的关键日志仍可分阶段获取和监控。
升级启动前：查看待安装更新详情与预检日志
在点击“立即升级”之前，系统已下载并验证更新包。这些操作会留下可查记录：
- 终端执行 softwareupdate --list 可确认待安装的完整更新名称（如 “macOS 15.0” 或 “macOS Security Update 2026-004”）
- 运行 softwareupdate --dump-state 查看当前更新状态缓存，含下载进度、校验结果及预检错误（如磁盘空间不足、签名验证失败）
- 检查 /var/log/install.log：该文件持续记录软件安装/升级事件，包括 macOS 升级触发前的准备步骤（如“Preparing system for update…”、“Verifying package integrity…”）
升级进行中：恢复环境下日志需手动捕获
进入恢复模式后，图形界面不显示详细日志，但底层仍在写入。你无法实时打开控制台，但可通过以下方式间接获取：
- 重启前按住 Cmd + R 进入恢复环境，再按 Cmd + Space 打开“终端”
- 在恢复终端中运行：log show --predicate 'subsystem contains "Installer" OR process == "osinstallersetup"' --last 2h —— 可读取升级启动初期的日志（部分日志在重启前已写入）
- 若升级卡住或失败，重启回正常系统后，/var/log/install.log 和 /var/log/system.log 会补全最后阶段记录，重点关注含 “osinstall”、“bootpd”、“diskmanagementd” 的条目
升级完成后：快速定位成败与残留问题
重启进入新系统后，第一时间检查三类日志源：
- 终端查更新历史：运行 sudo softwareupdate --history，确认目标版本是否出现在最新一行；若缺失或时间异常，说明升级未完成
- 查看 install.log 关键段落：用 tail -n 100 /var/log/install.log | grep -i "fail\|error\|rollback\|completed" 快速扫描最终状态
- 用控制台 App 筛选升级相关进程：打开“控制台”，搜索 p:osinstall 或 s:com.apple.installer，查看是否有 post-install 阶段报错（如配置迁移失败、证书加载异常）
长期追踪与导出升级日志用于分析
如需归档或提交给技术支持，建议导出结构化日志：
- 将完整升级时段日志导出为文本：log show --start "2026-07-07 08:00:00" --end "2026-07-07 12:30:00" --predicate 'subsystem contains "Installer"' --info --debug > upgrade_debug.log
- 同时保存 /var/log/install.log 副本：sudo cp /var/log/install.log ~/Desktop/install_log_$(date +%s).log
- 注意：恢复环境中的日志数据库（位于 /Volumes/Macintosh HD/usr/var/db/diagnostics）在升级后会被合并进主系统 unified logging，因此无需单独提取
