iCloud云盘同步卡死需四步排查：一、终端执行killall bird和cloudd重启进程；二、检查并清空iCloud存储空间；三、修复~/Desktop、~/Documents及~/Library/Application Support/CloudDocs权限；四、重命名CloudDocs文件夹并重启Mac重建缓存。

你的Mac上iCloud云盘图标一直在菜单栏转圈、访达里文件状态长期显示“正在上传”却毫无进度、新建文件不出现也不同步到iPhone——这不是网络慢，而是本地同步机制已陷入僵局。

强制重启同步核心进程

bird和cloudd是真正驱动iCloud文件同步的两个后台守护进程，它们卡死后会持续占用CPU、阻塞所有I/O操作，但系统既不报错也不弹窗，只让那个圆圈永远转下去。

打开“应用程序” → “实用工具” → “终端”，依次输入并回车：

killall bird

killall cloudd

等待10秒，观察菜单栏iCloud图标：若从旋转圆圈变为静态云朵，说明进程已成功拉起；若仍旋转，继续下一步。

重命名CloudDocs缓存文件夹

这一步必须在访达完全关闭iCloud云盘内任何子文件夹的前提下操作，否则终端会提示“目录忙”并失败。

第一步：按Command + Q退出访达，再按Command + Option + Esc调出“强制退出”窗口，确认访达未运行。

第二步：在终端中执行：

cd ~/Library/Application\ Support/

mv CloudDocs CloudDocs.backup

【必须重启Mac】，不能仅注销或重新登录iCloud账户。只有完整重启，系统才会检测到CloudDocs缺失，自动生成全新目录、重建全量索引、重新扫描所有文件并排队上传。

检查iCloud存储空间是否耗尽

配额满是同步卡死最隐蔽也最常见的原因——系统往往只在照片App里提示“储存空间已满”，而iCloud云盘界面却静默转圈，毫无警告。

方法一：前往“系统设置” → Apple ID → iCloud → 管理 → 重点清空“最近删除”相簿（常释放数GB）和旧设备备份。

方法二：在iPhone“文件”App中切换为“按大小排序”，快速定位并删除iCloud云盘中超过500MB的冗余文件。

腾出至少500MB后，再执行一次killall bird && killall cloudd。

验证关键目录权限是否异常

如果~/Desktop、~/Documents或~/Library/Application Support/CloudDocs被设为“只读”，iCloud就无法写入缓存或更新元数据，日历、备忘录甚至桌面图标都可能消失。

在访达中按Shift + Cmd + G，输入~/Library/Application Support/ → 右键CloudDocs → “显示简介” → 展开“共享与权限” → 点击锁图标输入密码 → 将当前用户权限改为“读与写”。

同样检查~/Desktop和~/Documents的权限。若权限栏显示“不能读取”，直接在终端运行：

sudo chown -R $(whoami) ~/Desktop ~/Documents ~/Library/Application\ Support/CloudDocs