iCloud云盘同步卡死需依次执行:重启bird/cloudd进程;重命名CloudDocs文件夹并重启Mac重建索引;检查并清理iCloud存储配额;修复关键目录读写权限;用brctl定位并移除阻塞文件。

Mac上iCloud云盘长期卡在“正在同步”状态,访达里文件夹旁圆圈持续旋转、进度条纹丝不动、新建文件不上传也不下载,说明同步机制已陷入僵局,不是网速慢或Apple服务宕机,而是本地进程锁死、缓存损坏、权限异常或单个文件阻塞所致。
强制重启同步核心进程
bird和cloudd是iCloud云盘真正的同步引擎,它们一旦僵死,所有上传任务都会挂起,但系统不会报错,只会无限等待。重启能强制释放TCP连接、清空内存中的错误状态,且不丢失任何本地文件。
打开“应用程序” → “实用工具” → “终端”。
依次输入并回车:
killall bird
killall cloudd
等待10秒,观察菜单栏iCloud图标:若从旋转圆圈变为静态云朵,说明进程已成功拉起;若仍是旋转状态,继续下一步。
重命名CloudDocs缓存文件夹重建索引
iCloud云盘依赖~/Library/Application Support/CloudDocs目录维护同步队列和版本映射。该文件夹一旦发生元数据损坏、权限错乱或结构异常,整个同步链路就会静默瘫痪——它不报错、不弹窗、不暂停,只是一动不动。
第一步:关闭所有应用,尤其确保“访达”没打开iCloud云盘里的任何子文件夹,否则mv命令会提示“目录忙”。
第二步:在终端中执行:
cd ~/Library/Application\ Support/
mv CloudDocs CloudDocs.backup
【必须重启Mac】,不能仅注销或重新登录iCloud账户。只有完整重启,系统才会检测到CloudDocs缺失,并自动生成全新目录、重建全量索引、重新扫描所有文件并排队上传。
检查iCloud存储配额是否耗尽
配额满会导致所有上传动作被直接中断,但系统未必弹窗提醒,只表现为“卡住”:访达圆圈停转、照片App提示“储存空间已满”、iCloud设置页显示红色警告。
前往系统设置 → Apple ID → iCloud → 管理。
重点清空三项:
• “最近删除”相簿(清空后常释放数GB)
• 旧设备备份(如“iPhone 12(已停用)”这类可直接删)
• iCloud云盘中的大文件(用iPhone的“文件”App按大小排序查找)
腾出至少500MB后,再执行一次killall bird && killall cloudd。
验证关键目录权限是否异常
如果~/Library/Application Support/CloudDocs、~/Desktop或~/Documents被设为“只读”或所有权丢失(比如权限栏显示“不能读取”),iCloud就无法写入缓存或同步内容,日历、备忘录也可能消失。
方法一:在访达中按Shift + Cmd + G,输入~/Library/Application Support/,右键CloudDocs → “显示简介” → 展开“共享与权限”,确认当前用户权限为“读与写”;若不是,点锁图标输入密码后修改。
方法二:同样检查~/Desktop和~/Documents的权限。
若权限栏提示“不能读取”,在终端中运行:
sudo chown -R $(whoami) ~/Desktop ~/Documents ~/Library/Application\ Support/CloudDocs
用brctl定位具体阻塞文件
单个文件就能拖垮整个同步队列:比如路径含中文括号、文件名超255字符、权限被第三方工具锁死、或PDF内嵌了损坏字体。brctl是Apple官方提供的底层诊断工具,能实时输出同步日志,精准暴露问题源头。
在终端中输入:
brctl log -w
保持窗口开启,观察滚动日志:若反复出现failed to upload、error processing item或某文件路径持续重复,就说明该文件就是阻塞点。
记下该路径,将对应文件移出iCloud云盘(例如剪切到桌面),再执行killall bird && killall cloudd。











