先重启bird和cloudd进程，再重命名CloudDocs文件夹重建同步队列；接着检查Apple服务状态与网络（含DNS和代理）；然后用Cirrus定位并重置卡住文件；最后新建标准用户测试是否为配置冲突。
如果您在Mac上使用iCloud时长期看到状态栏显示“正在同步”且无实际进度推进，文件未上传、日历或备忘录内容缺失，或系统反复提示“正在同步”却始终卡住，则可能是由于同步进程异常、本地缓存损坏、网络会话僵死、特定文件阻塞或用户配置冲突所致。以下是解决此问题的步骤：
一、重启iCloud同步核心进程
终止并重新加载bird与cloudd两个守护进程，可清除其内部挂起状态、释放僵死TCP连接，并强制重建与iCloud服务器的安全会话，不丢失任何本地数据。
1、打开“应用程序” > “实用工具” > “终端”。
2、在终端中依次输入以下命令，每行执行后按回车：
killall bird
killall cloudd
3、等待约10秒，观察菜单栏iCloud图标是否由旋转圆圈变为静态云朵图标。
二、重命名CloudDocs本地缓存文件夹
iCloud云盘依赖CloudDocs目录维护文件版本映射与同步队列，该文件夹若发生权限错误、结构损坏或元数据不一致，会导致同步完全挂起且无报错提示；重命名后系统将自动生成新目录并触发全量状态重建。
1、关闭所有正在运行的应用程序，尤其确保“访达”未打开iCloud Drive中的任意文件夹。
2、在“终端”中依次执行以下命令（注意空格与反斜杠）：
cd ~/Library/Application\ Support/
mv CloudDocs CloudDocs.backup
3、重启Mac，系统将在登录后自动生成新的CloudDocs文件夹，并开始重新扫描与排队同步任务。
三、检查Apple服务状态与本地网络环境
iCloud同步依赖稳定TLS握手与Apple后端服务可用性，区域性服务中断、DNS污染、代理干扰或Wi-Fi认证页未完成跳转均可能导致上传卡在“小量剩余”状态，需交叉验证两端状况。
1、使用Safari访问：https://www.apple.com/cn/support/systemstatus/。
2、确认“iCloud云盘”“iCloud登录”“iCloud日历”“iCloud备忘录”对应图标均为绿色正常状态。
3、断开当前Wi-Fi，切换至有线以太网或手机热点；或在“系统设置” > “网络”中点击当前连接右侧的“详细信息” > “DNS”，手动添加公共DNS（如8.8.8.8）。
4、关闭系统代理设置：进入“系统设置” > “网络” > 当前连接 > “详细信息” > “代理”，确保所有代理选项均未勾选。
四、重置特定阻塞文件同步状态
单个文件（如权限异常、路径过长、含非法字符或已损坏）可能拖住整个同步队列，通过专用工具可定位并单独重置该条目，避免全盘清理或数据重传。
1、从EclecticLight官网下载并安装Cirrus for Mac（免费开源工具）。
2、运行Cirrus，查看“Sync Status”面板中是否有标记为“Error”或“Stuck”的项目。
3、选择卡住的文件条目，点击“Reset Item”按钮重置其同步状态。
五、新建标准用户账户进行隔离测试
当前用户配置文件损坏（如偏好设置紊乱、钥匙串项异常、LaunchAgent冲突）可能导致iCloud服务初始化失败，新建标准用户可排除该类系统级配置干扰，快速定位问题根源。
1、打开“系统设置” > “用户与群组”，点击左下角锁形图标解锁。
2、点击“+”号添加新用户，类型选择“标准”，不勾选“允许用户管理此电脑”。
3、注销当前账户，登录新创建的标准用户。
4、进入“系统设置” > Apple ID > iCloud，开启“iCloud云盘”，观察同步状态是否仍显示“正在同步”。
