必须终止bird和cloudd进程并清除clouddocs缓存：先用killall命令强制退出双引擎，再重命名~/library/application support/clouddocs为备份，重启后系统自建新缓存；同时清理~/library/caches/cloudkit/和~/library/application support/apple/clouddocs/session/中的临时文件。
Mac上iCloud同步进程卡在“正在同步”状态、菜单栏图标持续旋转、活动监视器中bird或cloudd进程CPU占用居高不下，甚至文件被锁定无法移动删除——这些现象表明同步链路已僵死，必须立即终止后台进程并清除损坏的本地缓存，否则同步任务不会自动恢复，磁盘空间与系统响应将持续被拖累。
强制终止核心同步进程
bird和cloudd是iCloud同步的双引擎：bird负责元数据扫描与变更监听，cloudd负责实际文件上传下载。任一进程假死都会导致整个同步停滞，且界面无报错提示。
打开“终端”（应用程序 → 实用工具），依次执行以下两条命令，每条后按回车：
killall bird
killall cloudd
执行完毕等待10秒，观察菜单栏iCloud图标是否由旋转圆圈变为静态云朵。若仍旋转，说明进程未完全退出，可重复执行一次；【切勿连续快速敲击多遍，否则可能触发系统级进程保护机制，反而延长恢复时间】。
重建CloudDocs本地同步缓存
当同步反复卡住、灰色感叹号文件大量堆积、或重启进程后仍无法拉取新内容，大概率是~/Library/Application Support/CloudDocs目录结构损坏。该目录存储所有文件版本映射、冲突标记与同步队列，损坏后系统无法判断哪些文件该上传、哪些该下载。
第一步：关闭所有使用iCloud文档的应用，包括访达中任意打开的iCloud云盘窗口、Pages、Numbers、Keynote、Bear、Notability等；
第二步：在终端中执行：
cd ~/Library/Application\ Support/
mv CloudDocs CloudDocs.bak
第三步：重启Mac。系统登录时会自动生成全新CloudDocs文件夹，并开始重建云端状态映射表——此时菜单栏短暂显示“正在同步”属正常重建行为，通常2–4分钟内完成。
【操作前务必确认重要文档已手动另存本地副本，此步骤不删除iCloud云端文件，但会清空本地同步索引】。
清理深层隐藏的同步临时块
iCloud Drive在上传中断、网络抖动或App崩溃时，会把未完成的数据块写入不可见路径，Finder无法搜索，却真实占用数GB磁盘空间。
在访达中按Command + Shift + G，输入：
~/Library/Caches/CloudKit/
回车后，按“修改日期”排序，全选含“upload”“staging”“temp”字样的子文件夹，拖入废纸篓；【切勿删除CloudKit文件夹本身，只清空其内部内容】。
再按Command + Shift + G，输入：
~/Library/Application Support/Apple/CloudDocs/session/
删除该路径下所有文件（留空文件夹即可）。
验证同步进程是否真正终止
第一步：打开“活动监视器”，顶部搜索栏输入bird → 确认进程列表中无任何匹配项；
第二步：同样搜索cloudd → 确保无运行中进程；
第三步：在访达边栏点击“iCloud云盘”，检查是否仍有文件名旁带灰色感叹号或“正在同步”字样；
第四步：尝试移动一个曾被锁定的文件——若不再提示“该文件正由iCloud同步锁定”，即表示进程终止与缓存清理已生效。
