终端清理iCloud缓存可精准清除CloudKit上传下载暂存、CloudDocs损坏会话及Handoff后台队列，配合日志快照清理释放空间，避免Finder界面限制与同步卡死问题。
Mac终端清理iCloud同步缓存能直接绕过Finder界面限制，精准清除CloudKit、CloudDocs session、Handoff临时队列等深层残留，避免“移除下载”后仍卡住数十GB空间的问题。
清空CloudKit上传/下载暂存区
这一步针对iCloud Drive后台同步卡死、上传进度停滞、文件反复重试生成的staging缓存。访达无法访问该路径，必须用终端直达。
打开终端 → 执行：rm -rf ~/Library/Caches/CloudKit/{upload,download,staging}/*
命令会清空三个关键子目录下的全部内容，【不删除目录本身】，否则下次同步将因路径缺失而报错。若提示“Permission denied”，说明有cloudd进程正占用，先执行killall cloudd再重试。
强制重置CloudDocs会话状态
当“正在同步您的iCloud设置”长期卡在菜单栏，或iCloud云盘图标持续显示云朵+暂停，大概率是session目录中残留了损坏的握手凭证和断连会话。
方法一：安全清空（推荐）
终端中执行：rm -rf ~/Library/Application\ Support/Apple/CloudDocs/session/*
方法二：连目录一起重建（适用于反复失败场景）
先执行：rm -rf ~/Library/Application\ Support/Apple/CloudDocs/session
再执行：mkdir -p ~/Library/Application\ Support/Apple/CloudDocs/session
第二步会重建空白session目录，系统在下次同步时自动初始化新会话，比等待旧会话超时更可靠。
刷新Handoff与Continuity后台同步队列
跨设备接力、iPhone通话转发等功能会在后台持续维持网络会话，其缓存不进入CloudKit路径，但会锁住内存并拖慢整体同步响应。
第一步：禁用自动同步队列
终端输入：defaults write com.apple.nsurlsessiond NSUrlSessionDisableAutosync -bool YES && killall nsurlsessiond
第二步：清除蓝牙Handoff绑定缓存
执行：defaults write com.apple.bluetooth DisableHandoff -bool YES && killall blued
稍等3秒后恢复：defaults write com.apple.bluetooth DisableHandoff -bool NO && killall blued
这两步组合可立即释放被Handoff长期持有的/private/var/folders/下临时凭证，对频繁切换Mac/iPhone通话的用户效果立竿见影。
批量清理过期同步日志与快照
macOS 26新增实时协作功能后，CloudKit日志体积暴增，且部分快照被误判为同步缓存混入“系统数据”。手动删太慢，用脚本一次扫净。
① 清理30天前的CloudKit日志：find ~/Library/Logs/CloudKit -type f -mtime +30 -delete 2>/dev/null
② 删除最老一条本地Time Machine快照（仅一条，防误伤）：tmutil deletelocalsnapshots $(tmutil listlocalsnapshots / | tail -n +2 | head -n 1 | sed 's/^.*://')
③ 清空awdd系统级同步诊断日志：sudo rm -rf /var/log/awdd/*.log
【需输入管理员密码】，该操作不可逆，但日志本身无用户数据，仅用于苹果诊断。
