macOS自动升级失败主因是环境不达标：需20GB以上连续空间（非仅剩余容量）、稳定网络（推荐有线，DNS设223.5.5.5/1.1.1.1并重置IPv4）、清空/Library/Updates/与用户缓存、检查磁盘及固件状态。
macOS 自动升级安装失败，通常不是系统“坏了”，而是环境条件没达标或临时状态出了偏差。苹果的更新机制很严谨，宁可停在90%也不愿写入风险数据——所以报错其实是保护，不是故障。
存储空间不足（最常见）
显示“剩余25GB”不等于能装系统。安装器需要20GB以上连续未分配空间，用于解压、校验、迁移。碎片化空间、隐藏快照、缓存文件都会卡住流程。
- 打开“关于本机→存储空间→管理”，启用“自动清空废纸篓”和“优化存储”
- 访达中按 Shift+Command+G 输入
~/Downloads，删掉旧DMG、重复安装包、视频缓存 - 终端执行：
sudo tmutil thinlocalsnapshots / --keep-alive 1，清理时间机器本地快照（常释放5–12GB） - 重点清理：Xcode旧版本、Final Cut媒体库副本、虚拟机镜像（这些单个就占10GB+）
网络连接不可靠
DNS污染、IPv6握手延迟、mDNS缓存错误，会让安装器反复下载失败或卡在“正在验证”。网页能打开 ≠ 更新能连上。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 优先用原装USB-C转千兆以太网直连路由器（实测稳定性提升40%）
- 无线用户：系统设置→网络→Wi-Fi→详细信息→DNS，设为
223.5.5.5和1.1.1.1，并关闭IPv6 - 终端执行：
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder - 再重置IPv4协议栈：
networksetup -setv4off "Wi-Fi"→ 等3秒 →networksetup -setv4on "Wi-Fi"
缓存文件损坏
系统把安装组件缓存在两个地方：/Library/Updates/（系统级）和 ~/Library/Caches/com.apple.SoftwareUpdate/（用户级）。任一路径残留损坏包，都会触发签名验证失败。
- 终端一次性清空：
sudo rm -rf /Library/Updates/* && rm -rf ~/Library/Caches/com.apple.SoftwareUpdate/* - 重启后，不要点“重新尝试”，而是进“系统设置→软件更新”，点右下角“详情”，先勾选再取消“包括beta版本”——强制刷新索引
- 顺手检查“应用程序”里有没有残留的“安装macOS XXX”应用，拖进废纸篓并清空
磁盘或固件异常
APFS容器被锁、卷标损坏、EFI固件版本过旧，会导致升级中途重启失败、黑屏带禁止符号（?），或直接提示“此Mac不支持”（即使型号看似兼容）。
- 重启时按住 Command+R 进恢复模式，用“磁盘工具→急救”扫描启动卷
- 若提示“locked”或“corrupted”，终端执行：
diskutil list查看卷状态，必要时运行diskutil apfs unlockVolume diskXsY - 老Intel机型（如MacBookPro11,4）需确认逻辑板型号是否真在官方支持列表内，不能只看外观年份
- Apple芯片或T2芯片机型，若反复失败，可能需通过恢复模式修复固件（极少数情况）
