mac icloud云盘卡在“正在上传1个项目”时，应先执行killall bird和killall cloudd重启进程释放文件锁；再用brctl log -w定位并删除含特殊字符的失败文件；最后重命名clouddocs文件夹并重启以重建同步索引。
Mac上iCloud Drive长期卡在“正在上传1个项目”且毫无进展，不是网络慢也不是Apple服务宕机，而是bird进程锁死在某个文件上，同步队列彻底僵住，本地文件无法移动、修改，访达持续提示“文件正在被使用”。
强制终止同步进程释放文件锁
这是最快速有效的第一步，能立刻解除对目标文件的I/O锁定：
打开“终端”，依次输入并回车：
killall bird
killall cloudd
系统会在5秒内自动重启两个进程，菜单栏iCloud图标由旋转圆圈变为静态云朵，卡住的文件夹通常立即可操作。
若仍显示“正在上传1个项目”，说明该文件已触发bird内部重试死循环，必须进入下一步定位。
用brctl日志定位卡死文件
bird不会告诉你卡在哪，但brctl会实时吐出失败路径：
在终端中输入：brctl log -w 回车
等待10–15秒，观察滚动日志中反复出现的同一行错误，典型格式为：
【failed to upload /iCloud Drive/Projects/Report_final_v3(2024).pdf】
注意括号、空格、中文顿号、冒号等特殊字符——它们是90%卡死文件的共同特征。
立即在访达中前往该路径，右键该文件 → “移到废纸篓”；
清倒废纸篓，避免残留引用继续触发重试；
这一步操作起来很简单，直接把文件拖进去就行，无需担心丢失——它还在iCloud云端完好保存。
重建本地同步索引（缓存重置）
当单个文件清理无效，或日志无输出但状态仍卡死，说明CloudDocs缓存数据库已结构性损坏，必须重建：
第一步：关闭所有应用，尤其确保访达未打开任何iCloud云盘子文件夹；
第二步：终端中依次执行：
killall bird
cd ~/Library/Application\ Support/
mv CloudDocs CloudDocs.backup
第三步：重启Mac；
系统登录后自动生成全新CloudDocs文件夹，并开始重新扫描本地文件结构；
【此操作不删除你硬盘上的任何文件，仅重置同步元数据】
原卡死的“正在上传1个项目”状态将彻底消失，取而代之的是完整的新同步队列。
