Mac iCloud同步失败后，通常需要清理残留文件、重启bird与cloudd进程、重建CloudDocs缓存、删除隐藏临时数据块、清除邮件和信息附件缓存，并通过brctl reset重置被阻塞文件的同步状态，才能更彻底地恢复iCloud云盘同步。
Mac出现iCloud同步失败后，本地往往会残留大量无法上传、无法下载、图标带灰色感叹号的异常文件，以及被bird进程占用但已经失效的缓存数据块。这些残留内容不仅不会继续参与iCloud同步，还会持续占用磁盘空间，严重时甚至会拖慢或阻塞后续全部同步任务。
定位并删除同步失败的残留文件
1、打开“访达”，在左侧边栏点击“iCloud云盘”。
2、逐层展开文件夹，重点检查文件名旁带有灰色感叹号或完全没有状态图标的项目；这类文件通常已经中断同步超过48小时，相关元数据可能已损坏，系统通常不会再自动处理。
3、选中目标文件或文件夹，按Command + Delete移入废纸篓；如果系统提示“文件正在使用”，请先按照下一部分的方法重启同步进程后再尝试删除。
4、右键点击Dock栏中的废纸篓图标 → 选择“清空废纸篓”；【这一步不能省略，否则磁盘空间无法真正释放】。
重启同步进程并重置缓存结构
Mac上的iCloud同步卡住，常见原因是bird或cloudd进程异常僵死。此时仅删除文件通常无效，必须重启相关进程并刷新缓存上下文。
方法一：强制重启核心同步进程
1、打开“终端”（应用程序 → 实用工具）；
2、依次执行：
killall bird
killall cloudd
3、等待10秒，观察菜单栏中的iCloud图标是否从旋转状态恢复为静态云朵。
方法二：重建CloudDocs缓存目录（适合灰色图标反复出现的情况）
第一步：关闭Pages、Numbers、Keynote、Bear、Notability等所有文档类App；
第二步：在终端中执行：
cd ~/Library/Application Support/
mv CloudDocs CloudDocs.bak
第三步：进入“系统设置”→“Apple ID”→右上角“退出登录”，确认退出后重新输入Apple ID密码登录；
第四步：等待2～3分钟，系统会自动生成新的CloudDocs文件夹，并重新拉取云端最新同步状态映射。
清理深层隐藏的同步临时块
如果iCloud Drive在上传过程中突然中断、网络瞬间波动，或者相关App意外崩溃，系统往往会把未上传完成的数据块写入隐藏目录。Finder里通常不容易直接搜到，但这些临时文件会持续占用Mac存储空间，少则几GB，多时会明显影响可用容量。
1、在访达中按Command + Shift + G，输入：
~/Library/Caches/CloudKit/
2、回车后按“修改日期”排序，重点查看名称中带有“upload”“staging”“temp”的子文件夹；
3、将这些文件夹全选后拖入废纸篓；
【不要删除CloudKit文件夹本身，只清理其内部内容】；
4、然后再次按Command + Shift + G，输入：
~/Library/Application Support/Apple/CloudDocs/session/
5、删除该路径下的所有文件，保留文件夹为空即可。
清除邮件与信息App的同步附件残留
“邮件”和“信息”App会在Mac本地保留iCloud同步附件的完整副本，尤其是图片和视频等大文件。即使你已经在iPhone上删除了原始消息，Mac端仍可能保留对应附件，久而久之会占用不少空间。
第一步：清理邮件附件
打开“邮件”App → 顶部菜单栏点击“邮箱”→“清理”→“清理已删除邮件”→ 勾选“包括附件”→ 点击“清理”。
第二步：清空信息App缓存
访达→ Command+Shift+G → 输入~/Library/Containers/com.apple.iChat/Data/Library/Caches/→ 回车 → 删除其中所有以Medi开头的文件夹。
扫描并重置阻塞文件的同步注册项
有些文件会被bird直接拒绝同步，常见原因包括权限状态异常、路径过长、文件名包含非法字符，或者文件正被其他进程占用。遇到这种情况，与其反复在图形界面里尝试，不如直接使用命令行工具重置同步注册项，通常更稳定，也更适合精准处理异常文件，同时保留原始内容。
① 打开“终端”；
② 输入并执行：
cd ~/Library/Mobile Documents/
ls -1
③ 找到com~apple~CloudDocs（通用iCloud Drive容器），然后进入：
cd com~apple~CloudDocs
④ 执行：
brctl reset --all
⑤ 等待约15秒，再返回访达查看原文件的状态图标是否已经变为实心云朵加向下箭头，或者不再显示异常图标（表示同步状态已恢复就绪）。
