icloud同步死锁导致访达显示“正在上传”且文件夹无法移动，本质是bird与cloudd进程卡死并锁定目录i/o；应先执行killall bird和killall cloudd释放锁，再视情况用mv命令绕过同步移动、重置clouddocs缓存或启用“始终保留在本台mac上”。
macos中icloud同步死锁会导致文件夹在访达里显示“正在上传”却长期不动，右键移动、剪切或拖拽时提示“无法移动，文件正在被使用”或“操作无法完成，因为项目正在被同步”。这本质上不是权限或磁盘问题，而是bird和cloudd进程卡在某个文件状态上，锁住了整个目录树的i/o操作。
强制终止同步进程释放文件锁
这是最直接有效的第一步，能立即解除对文件夹的占用：
- 打开“终端”，依次执行两行命令（每行后按回车）：
killall bird
killall cloudd - 系统会在几秒内自动重启这两个进程，原卡住的文件夹通常立刻可操作
- 若仍被锁定，可补充执行：brctl log -w观察实时日志，确认是否有持续报错的文件路径
临时绕过同步机制移动文件夹
当急需转移数据且不想等待同步恢复时，可用系统级命令跳过访达的同步检查：
- 在终端中用mv命令直接移动（例如：mv ~/Library/Mobile\ Documents/com~apple~Notes/ ~/Desktop/Notes_Backup/）
- 该操作不经过iCloud同步层，只要文件未被其他应用打开，就能成功
- 移动后，原iCloud云盘中对应位置会变为空白或显示“下载”图标，后续可手动重新同步
重置同步缓存并重建索引
适用于反复出现死锁、多个文件夹同时无法移动的情况：
- 先关闭所有应用，确保无后台同步任务
- 在终端中运行：cd ~/Library/Application\ Support && mv CloudDocs CloudDocs.bak
- 重启Mac，系统会生成全新CloudDocs文件夹，并从云端重新拉取文件结构
- 此时原卡死的文件夹已脱离旧同步上下文，可自由移动或删除
检查并修正文件存储策略
部分文件夹因启用“优化Mac存储”而仅保留快捷方式，移动时易触发同步冲突：
- 在访达中右键点击目标文件夹 → 选择“显示简介”
- 在“通用”区域查看是否标注“存储在iCloud中，不在本机”
- 若确认是此状态，先右键该文件夹 → 选择“始终保留在本台Mac上”，等进度条走完再移动
- 特别注意嵌套过深（如超过8级子文件夹）或含特殊字符（如:、/、?）的路径，建议先重命名再操作
