先重启bird和cloudd进程，再重命名clouddocs文件夹重建同步队列；接着检查apple服务状态与本地网络（含dns和代理）；然后用cirrus定位并重置卡住文件；最后清理icloud存储空间释放配额。
Mac上iCloud云盘长期卡在“正在同步”状态，文件上传进度条不动、图标持续旋转、访达里文件状态始终显示“等待上传”或“正在上传”，说明同步流程已被阻塞，不是网络慢，而是底层机制已失效。
重启同步核心进程
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缺失，并自动生成全新目录、重建全量索引、重新扫描所有文件并排队上传。
检查Apple服务与本地网络
同步卡在“还剩几KB”却永远不动，大概率不是Mac的问题，而是Apple服务端区域性中断，或本地DNS被污染导致TLS握手失败——设备连不上认证服务器，自然无法推进同步。
方法一：用Safari访问 https://www.apple.com/cn/support/systemstatus/，确认“iCloud云盘”“iCloud登录”两项图标为绿色对勾。
方法二：断开当前Wi-Fi，切换至手机热点；或进入“系统设置” → “网络” → 当前连接 → “详细信息” → “DNS”，手动添加8.8.8.8和1.1.1.1。
方法三：进入“系统设置” → “网络” → 当前连接 → “详细信息” → “代理”，确保HTTP、HTTPS、SOCKS等所有代理开关全部关闭。
定位并重置阻塞文件
单个文件就能拖垮整个同步队列：比如路径含中文括号、文件名超255字符、权限被第三方工具锁死、或PDF内嵌了损坏的字体。这类文件会卡在“Stuck”状态，其他文件全得排队等它。
第一步：从EclecticLight官网下载免费开源工具Cirrus for Mac并安装。
第二步：启动Cirrus，点击左下角“Select DB”，选择路径：
~/Library/Caches/com.apple.icloud.fmfd/
第三步：点击“Scan Sync Queue”，等待扫描完成，找出状态列为“Stuck”或“F”的条目。
第四步：选中该条目 → 点击右下角“Reset Item”，工具会清除其同步注册状态，但保留本地文件原样不动。
这一步做完，菜单栏iCloud图标通常会在30秒内开始转动，且访达中对应文件的状态图标会更新。
清理iCloud存储空间
当iCloud配额已满，同步会立刻停止，所有上传任务转入“暂停队列”，界面仍显示“正在同步”，实则毫无动作——这是Apple的硬性限制，不是bug，也不是延迟。
① 打开“照片”App → 左侧边栏点“最近删除” → 右上角“选择” → “全部删除” → 弹窗点“删除”。
② 打开“访达” → 左侧点“iCloud云盘” → 进入“最近删除”文件夹 → 全选 → Command + Delete → 清空废纸篓。
③ 进入“系统设置” → Apple ID → “iCloud” → “管理” → “备份”，删掉已停用设备（如“iPhone 11(已换机)”）的备份。
④ 在iCloud网页端（iCloud.com）登录同一账号，进入“iCloud云盘”，按大小排序，手动删除过期合同、未剪辑视频、旧版设计稿等大文件。
空间释放后，立即回到终端执行：
killall bird
killall cloudd
