最典型症状是访达中无法重命名iCloud文件，因bird/cloudd进程卡死锁住元数据；应先执行killall bird与killall cloudd重启进程，再重命名CloudDocs文件夹清缓存，最后确认文件设为“始终保留在本台Mac上”。

当 macos 中 icloud 同步任务死锁时，最典型的症状之一就是：你在“访达”中右键或双击一个 icloud 云盘里的文件/文件夹，却无法重命名——点击后名称不进入可编辑状态，或者按 return 键无反应，甚至系统提示“该文件正在同步中，无法修改”。这并非权限或系统限制问题，而是 bird 或 cloudd 进程卡在某个同步状态，锁住了文件的元数据操作权限。

强制重启同步核心进程

iCloud 文件同步依赖两个关键后台进程：bird（负责文件变更监听与上传队列）和 cloudd（处理账户认证、元数据同步与冲突协调）。一旦它们卡死，连重命名这类基础操作都会被阻塞。

• 打开“终端”，依次执行：
• killall bird
• killall cloudd
• 等待约 10 秒，系统会自动拉起新进程；此时可立即尝试重命名文件

绕过缓存锁定重置同步状态

如果重启进程后仍无效，说明本地缓存（CloudDocs）中残留了异常锁标记。直接重命名该缓存文件夹可清空所有待决状态，且不会删除你已存在的文件（仅重置同步逻辑）。

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

• 先关闭所有访达窗口及可能访问 iCloud 的 App（如 Pages、Notes）
• 在终端中运行：
• cd ~/Library/Application\ Support
• mv CloudDocs CloudDocs.bak
• 重启 Mac 或重新登录 iCloud 账户（系统设置 → Apple ID → 退出再登录）

检查并解除文件的“优化存储”锁定

即使同步未卡死，若文件被设为“仅在 iCloud 中保留”（即未勾选“始终保留在本台 Mac 上”），macOS 会拒绝对其执行重命名等本地操作，因为实际文件内容尚未下载完成。

• 在访达中定位该文件 → 右键 → 查看简介
• 在“通用”栏确认是否显示“存储在 iCloud 中”且无本地副本图标
• 若如此，右键文件 → 选择“始终保留在本台 Mac 上”，等待下载完成后再重命名

用 brctl 日志快速定位卡点

如果你频繁遇到此问题，建议用系统自带工具实时观察同步行为，避免盲目操作：

• 终端中运行：brctl log -w
• 复现重命名失败动作，观察日志末尾是否持续出现 waiting for lock、stuck on item 或反复报同一文件路径
• 若发现某文件反复出错，可用 Cirrus 工具（EclecticLight.co 提供）单独重置它，而非重置整个云盘