重启bird和cloudd进程可快速解决icloud文件夹图标卡在“正在上传”或旋转状态的问题，因同步异常多由进程内部状态卡死导致，本地文件完好，无需重启mac或退出登录。
MacOS iCloud 文件夹图标卡在“正在上传”“暂停”或一直旋转，多数不是真卡死，而是同步状态显示异常，尤其常见于文件名冲突、权限错乱、元数据不一致或单个阻塞文件拖住整队列。重点不在删文件，而在重置同步上下文。
iCloud 同步进程强制重启
bird 和 cloudd 是 macOS 管理 iCloud 文件同步的两个核心后台进程。它们偶尔会卡在内部状态里，导致图标僵住、上传停滞，但本地文件完好无损。重启它们成本最低、见效最快：
- 打开“终端”（应用程序 → 实用工具）
- 依次输入并回车：killall bird，再输killall cloudd
- 等待 10–15 秒，观察菜单栏 iCloud 图标：从旋转圆圈或暂停图标变回静态云朵，说明进程已拉起
- 不用重启 Mac，也不用退出登录，多数情况下图标立刻恢复正常
重置 CloudDocs 缓存目录
iCloud 云盘依赖 ~/Library/Application Support/CloudDocs 存储同步索引、版本哈希和排队任务。这个文件夹一旦损坏（比如断电、强制关机、磁盘权限异常），就会让整个同步队列陷入“假死”，且不报错、不提示。
- 先关闭访达、照片、备忘录等可能调用 iCloud 的 App
- 在终端中运行：cd ~/Library/Application\ Support/（注意空格和反斜杠）
- 再运行：mv CloudDocs CloudDocs.backup（把原缓存重命名备份）
- 重启 Mac 或重新登录 iCloud 账户（系统设置 → Apple ID → 退出再登录），系统会自动生成新 CloudDocs 并开始重建同步状态
- 本地文件不会丢失，只是同步进度需重新扫描，大文件夹首次刷新可能需要几分钟
定位并绕过阻塞文件
一个文件出问题（比如路径含非法字符、权限为 root、大小超限、或已损坏），就可能导致整个文件夹同步挂起。这时全量重置缓存反而低效。可尝试：
- 打开访达，进入 iCloud 云盘，找最近新增/修改的文件或文件夹，右键 → “始终保留在本台 Mac 上”（确保它没被优化存储卸载）
- 若某个子文件夹图标单独卡住，可复制该文件夹（访达中按 Option 拖拽），新副本通常图标立即正常；确认内容无误后，删除原文件夹再让副本同步
- 进阶排查可用 brctl log -w（终端命令）实时看同步日志，滚动中若反复出现同一文件路径 + “conflict”或“permission denied”，基本就是它
验证服务与网络基础状态
图标卡死有时是假象——实际是连接不到 Apple 服务器。别跳过这步检查：
- 用 Safari 打开 Apple 系统状态页，确认“iCloud云盘”“iCloud登录”显示绿色对勾
- 临时切换网络（比如用手机热点），排除 DNS 污染、企业防火墙或 Wi-Fi 认证页未完成等问题
- 系统设置 → 网络 → 当前连接 → 详细信息 → 代理，确保所有代理选项都未启用
- 如果仅某类文件（如 Pages、Numbers）不同步，也可能是对应 App 自身未开启 iCloud 支持，在“系统设置 → Apple ID → iCloud”里单独检查这些 App 的开关
