必须清除灰色感叹号文件、.tmp/.part临时文件及损坏的clouddocs缓存，否则持续阻塞bird进程队列；需依次执行：删除带感叹号文件并清空废纸篓、brctl reset重置同步状态、清理caches/cloudkit与application support/clouddocs目录、killall bird/cloudd重启进程。
Mac上iCloud同步出错后，本地常残留灰色感叹号文件、.tmp/.part临时块、损坏的CloudDocs缓存，这些脏数据会持续阻塞bird进程队列，导致新文件无法上传、状态卡在“等待上传”或图标空白——必须主动清除才能恢复同步。
定位并删除带灰色感叹号的失败文件
同步失败的文件元数据已损坏，图形界面无法正常操作，但它们仍牢牢锁住bird进程，不删掉就永远卡住。【必须立刻清空废纸篓】，否则残留条目仍会干扰状态刷新。
1、打开“访达”，左侧边栏点击“iCloud云盘”。
2、逐级展开目录，寻找文件名旁带灰色感叹号图标（不是云朵+暂停）或完全无状态图标的项。
3、选中目标文件或文件夹，按Command + Delete移入废纸篓。
4、右键Dock栏废纸篓图标 → “清空废纸篓”。
用终端重置同步状态（保留原始文件）
有些文件内容完好，只是注册信息错乱，比如被其他App锁定、路径含非法字符、扩展名异常。此时删文件是浪费，直接重置同步注册项更稳妥。
方法一：全局重置iCloud Drive缓存
1、打开“终端”（应用程序 → 实用工具）。
2、输入命令并回车：cd ~/Library/Mobile\ Documents/com~apple~CloudDocs。
3、执行：brctl reset --all。
4、等待约15秒，返回访达查看原文件状态是否更新为实心云朵加向下箭头。
方法二：精准重置单个文件
1、在访达中右键目标文件 → “在访达中显示”，复制完整路径（如/Users/John/Library/Mobile Documents/com~apple~CloudDocs/Notes/week1.md）。
2、终端中执行：brctl reset "/Users/John/Library/Mobile Documents/com~apple~CloudDocs/Notes/week1.md"（注意引号包裹真实路径）。
清理隐藏的同步临时文件与缓存目录
iCloud Drive在中断上传、网络抖动或App崩溃时，会在系统深处留下.tmp、.part、staging等不可见文件，Finder默认不显示，但它们长期占空间且干扰同步。
第一步：清空CloudKit缓存区
1、访达 → 顶部菜单栏「前往」→「前往文件夹…」（或按Command+Shift+G）。
2、输入~/Library/Caches/CloudKit/ → 回车。
3、重点删除名称含“upload”“download”“staging”或修改日期超7天的子文件夹。
4、选中后按Command+Delete移入废纸篓。
第二步：清除CloudDocs会话残留
1、同样用Command+Shift+G打开文件夹窗口。
2、输入~/Library/Application Support/CloudDocs → 回车。
3、若该目录存在且非空，将其整个拖入废纸篓。
4、重启Mac，系统将自动生成全新CloudDocs文件夹并重建同步索引。
强制重启同步核心进程
bird和cloudd两个守护进程一旦挂起，所有同步动作都会停滞，哪怕缓存已清、文件已删。重启它们是最轻量级的“断电再开机”式修复。
1、打开“终端”。
2、依次执行以下两行命令，每行后按回车：killall birdkillall cloudd
3、等待10秒，观察菜单栏iCloud图标是否由旋转圆圈或暂停图标变为静态云朵图标。
