iCloud同步失败需清除本地脏数据：删带灰色感叹号文件并清空废纸篓；用brctl reset重置同步状态；清理.tmp/.part等隐藏临时文件；清空iCloud专用废纸篓。
Mac上iCloud同步失败后，文件图标出现灰色感叹号、右键菜单中“始终保留在本台Mac上”变灰、访达里文件空白或反复卡在“等待上传”，说明本地残留已损坏，必须清除这些阻塞同步队列的脏数据才能恢复正常。
定位并强制删除带灰色感叹号的文件
同步失败的文件常驻本地却无法完成校验，其元数据已“脏化”，继续保留会阻塞整个bird进程队列。直接删掉最有效，且不会影响iCloud服务器端已有副本——前提是该文件此前已成功上传过。
1、打开“访达”，左侧边栏点击“iCloud云盘”。
2、逐级展开目录，寻找文件名旁带【灰色感叹号图标】或完全无状态图标的项（注意：不是云朵+暂停图标，那是上传中；感叹号才是失败态）。
3、选中目标文件或文件夹，按Command + Delete移入废纸篓。
4、【必须立刻清空废纸篓】：右键Dock栏废纸篓图标 → “清空废纸篓”。若仅移入不清理，残留仍会干扰同步状态刷新。
用终端重置同步状态（保留文件内容）
某些文件因权限锁定、扩展名异常或被其他进程占用，图形界面无法操作，但内容完好。此时跳过删除，直接重置其同步注册项更安全。
方法一：全局重置iCloud Drive同步缓存
1、打开“终端”（应用程序 → 实用工具）。
2、输入命令并回车：cd ~/Library/Mobile\ Documents/com~apple~CloudDocs。
3、执行：brctl reset --all。
4、等待约15秒，返回访达查看原文件状态是否更新为实心云朵加向下箭头——这表示bird已重新纳入该文件处理队列。
方法二：精准重置单个文件路径（适用于已知绝对路径）
1、在访达中右键目标文件 → “在访达中显示”，确认其完整路径（如~/Library/Mobile Documents/com~apple~CloudDocs/Project/report.docx）。
2、终端中执行：brctl reset "/Users/YourName/Library/Mobile Documents/com~apple~CloudDocs/Project/report.docx"（将路径替换为你的真实路径，注意引号包裹）。
这一步绕过GUI限制，强制bird丢弃旧同步记录并重建索引，不碰原始内容字节。
清除隐藏的临时块与断点续传碎片
iCloud同步中断时，会在深层路径留下.tmp、.part等不可见文件，它们不显示在访达默认视图中，却持续占用空间并干扰新任务启动。
第一步：显示隐藏文件并人工筛查
1、在iCloud云盘根目录或疑似问题子文件夹内，按下Command + Shift + .（句点）。
2、肉眼扫描是否存在以.tmp、.part、.crdownload、.incomplete结尾的文件——尤其注意名称含“uploading”“staging”字样的。
3、选中后直接拖入废纸篓，立即清空。
第二步：终端批量定位网盘相关临时文件
1、打开终端，粘贴执行：
find ~/Library -name "*.tmp" -o -name "*.part" -o -name "*.crdownload" 2>/dev/null | grep -i "icloud\|cloud\|mobile"
2、对输出的每条路径，用ls -la [路径]确认修改时间是否超过3天，再执行rm -f [路径]删除。
注意：【不要直接运行rm -rf命令批量删除】，grep结果可能匹配到系统关键路径，务必逐条验证后再删。
清空iCloud云盘专用废纸篓
iCloud云盘的废纸篓独立于本地废纸篓，里面存放的已删除项目仍占用本地缓存空间，且30天后才自动清除——这期间它们持续拖慢同步速度。
1、访达左侧边栏展开“iCloud云盘”，点击下方出现的“废纸篓”条目。
2、全选所有项目 → 右键 → “立即删除”。
3、弹窗确认后，这些项目从本地缓存和云端元数据中同步移除，不再参与任何同步队列计算。
