mac icloud云盘同步卡死需按四步排查：一、终端执行killall bird和cloudd重启进程；二、检查icloud存储空间，清空“最近删除”等释放配额；三、修复~/library/application support/clouddocs及~/desktop、~/documents权限；四、重命名clouddocs文件夹并重启以重建缓存。
Mac 上 iCloud 云盘同步卡死、进度圈一直转、文件不上传也不下载，通常不是网络慢或 Apple 服务宕机，而是本地同步机制陷入僵局。核心问题往往出在进程锁死、缓存损坏、权限异常或存储策略冲突上。下面四类排查路径覆盖绝大多数真实场景，按操作难度和见效速度排序，建议从第一项开始逐项尝试。
一、强制重启同步进程（最快见效）
bird 和 cloudd 是 macOS 中负责 iCloud 文件同步的两个关键后台进程。它们一旦卡住，就会持续占用资源、阻塞 I/O，导致访达里文件夹显示“正在上传”却无法移动或修改。
- 打开“终端”，依次输入并回车：
- killall bird
- killall cloudd
- 等待 5–10 秒，观察菜单栏 iCloud 图标是否恢复跳动，或访达中进度圈是否开始推进
- 若仍无反应，可补一句 brctl log -w 查看实时日志——滚动中若反复出现 failed to upload 或 error processing item，说明有具体文件触发了错误
二、检查 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
四、重置 CloudDocs 缓存目录（适用于反复卡死）
当同步长期异常、多个文件夹同时无法操作、或重启进程无效时，本地缓存元数据很可能已损坏。重建 CloudDocs 是最彻底的清理方式，系统会丢弃旧索引，从云端重新拉取结构。
- 先执行 killall bird && killall cloudd
- 终端中依次输入：
- cd ~/Library/Application\ Support
- mv CloudDocs CloudDocsOld
- 重启 Mac
- 开机后系统自动创建新 CloudDocs，并开始同步——原卡死的文件夹此时已脱离旧上下文，可自由移动或删除
