Mac iCloud同步失败后需清理残留文件、重启bird/cloudd进程、重建CloudDocs缓存、清除隐藏临时块、清理邮件与信息附件，并用brctl reset重置阻塞文件同步状态。
Mac上iCloud同步失败后，本地会残留大量无法上传、无法下载、图标带灰色感叹号的文件，以及被bird进程锁定却已失效的缓存块——这些数据既不参与同步，又持续占用磁盘空间，甚至阻塞后续所有同步任务。
定位并删除同步失败的残留文件
1、打开“访达”，左侧边栏点击“iCloud云盘”。
2、逐级展开目录，重点查找文件名旁带有灰色感叹号或完全无状态图标的条目；这类文件通常已中断同步超48小时，元数据损坏，系统不再尝试处理。
3、选中目标项，按Command + Delete移入废纸篓；若提示“文件正被使用”，请先执行下一部分的进程重启步骤再重试。
4、右键点击Dock栏废纸篓图标 → 选择“清空废纸篓”；【这一步不可跳过，否则磁盘空间不会释放】。
重启同步进程并重置缓存结构
同步卡死常因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文件夹，并开始拉取云端最新状态映射表。
清理深层隐藏的同步临时块
当上传中断、网络抖动或App崩溃时，iCloud Drive会把未完成的数据块写入不可见路径，Finder搜不到，但实际占数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会把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秒，返回访达查看原文件状态指示器是否更新为实心云朵加向下箭头或无图标（已就绪）。
