macOS更新失败后需清除残留文件：一、清空/Library/Updates和缓存；二、删除本地Time Machine快照碎片；三、恢复模式下修复APFS卷；四、清理系统日志与临时目录；五、重建软件更新服务配置。
如果您尝试完成macOS系统更新，但安装过程意外中断、回滚或报错退出，则系统可能在磁盘中残留未清理的临时解压文件、损坏的安装包缓存、校验失败的宗卷快照及中断写入的APFS快照碎片，这些内容不会出现在访达中，却持续占用空间并干扰后续更新。以下是清除此类更新失败残留碎片文件的具体操作：
一、强制清除系统更新缓存与中断安装器残留
macOS更新失败后，/Library/Updates 和 ~/Library/Caches/com.apple.SoftwareUpdate 中会保留已下载但未验证通过的组件包、部分解压的固件镜像及签名校验中间文件；这些文件被标记为“不可覆盖”，需手动清空才能释放连续空间并重置安装索引。
1、打开终端，粘贴并执行以下命令：sudo rm -rf /Library/Updates/* && sudo rm -rf ~/Library/Caches/com.apple.SoftwareUpdate/*
2、输入管理员密码（输入时无显示），按回车确认执行。
3、执行完成后，不重启，直接在终端中运行：defaults write com.apple.SoftwareUpdate CatalogURL https://swscan.apple.com/content/catalogs/others/index-14-13-12-11-10.16-10.15-10.14-10.13-10.12-10.11-10.10-10.9-mountainlion-lion-snowleopard-leopard.merged-1.sucatalog
4、关闭终端，进入“系统设置→软件更新”，点击右下角“详情”按钮刷新可用更新列表。
二、删除中断更新生成的本地时间机器快照碎片
当macOS更新在准备阶段（如“正在配置更新”）失败时，系统会自动创建本地快照用于回滚，但失败后该快照常处于“未挂载”“不可见”状态，仍计入磁盘占用且无法通过常规界面清理；其元数据残留在APFS容器中，形成空间碎片。
1、在终端中执行：tmutil listlocalsnapshots /，查看是否存在名称含“com.apple.TimeMachine.”且时间戳接近更新失败时刻的快照。
2、若返回结果非空，执行：sudo tmutil thinlocalsnapshots / 9999999999 1，强制清除所有本地快照。
3、继续执行：diskutil apfs listSnapshots /System/Volumes/Data，确认输出为空或仅剩系统默认快照。
4、如仍有残留快照ID显示，记下ID（如com.apple.os.update-2026-04-23-142211），执行：sudo tmutil deletelocalsnapshots com.apple.os.update-2026-04-23-142211。
三、修复APFS宗卷中因更新中断导致的空间映射异常
更新失败可能导致APFS容器内部分块组（block group）状态异常，表现为“可用空间”与“可清除空间”数值严重偏离，或“储存空间”界面中“系统数据”长期虚高；此时需在恢复模式下运行第一性原理级修复，而非仅依赖GUI优化。
1、关机后，按住 电源键 + Command + R 直至出现旋转地球图标，进入macOS恢复模式。
2、顶部菜单栏选择“实用工具→终端”。
3、在终端中输入：diskutil list，识别内置磁盘标识符（通常为 disk0s1 或 disk1s1）。
4、执行：diskutil apfs repairVolume /dev/diskXsY（将X和Y替换为实际编号，例如disk1s1）。
5、等待提示“Volume repair complete”后，输入 reboot 重启。
四、清空系统级临时目录中隐藏的更新日志与诊断归档
更新失败时，/private/var/log/install.log、/var/db/.AppleUpgrade 和 /private/var/folders/ 下的随机哈希路径中会生成大量调试日志、崩溃堆栈及未完成的迁移任务归档；这些文件受系统保护，普通用户不可见，但持续占用数GB空间。
1、重启进入正常系统，在终端中执行：sudo log show --predicate 'eventMessage contains "OSInstaller"' --last 7d > ~/Desktop/update_logs.txt，导出最近7天更新相关日志供排查。
2、执行：sudo rm -f /private/var/log/install.log*，清除主安装日志轮转文件。
3、执行：sudo rm -rf /var/db/.AppleUpgrade，彻底移除升级状态跟踪目录。
4、执行：sudo find /private/var/folders -name "*OSInstall*" -type d -maxdepth 3 -exec rm -rf {} + 2>/dev/null，精准定位并删除所有含OSInstall标识的深层临时目录。
五、重建软件更新服务进程与偏好配置
更新失败可能使com.apple.SoftwareUpdate后台服务陷入僵死状态，其偏好文件（~/Library/Preferences/com.apple.SoftwareUpdate.plist）中的LastCheckDate、AutomaticCheckEnabled等键值错误锁定，导致后续检查始终复用损坏缓存。
1、在终端中执行：launchctl bootout gui/$(id -u) /System/Library/LaunchAgents/com.apple.SoftwareUpdate.plist，卸载当前用户下的更新服务代理。
2、执行：rm ~/Library/Preferences/com.apple.SoftwareUpdate.plist，删除损坏偏好文件。
3、执行：launchctl bootstrap gui/$(id -u) /System/Library/LaunchAgents/com.apple.SoftwareUpdate.plist，重新加载服务代理。
4、最后执行：softwareupdate --list，验证系统是否能正确获取最新可用更新列表。
