iCloud Drive上传停滞可依次通过重启同步进程、清除缓存、检查网络与服务状态、重置阻塞文件、新建用户测试来解决，各步骤均不删除本地文件且针对性强。

如果您在Mac上使用iCloud Drive时发现状态栏长期显示“正在上传”且进度停滞，文件实际未同步完成，则可能是由于同步进程异常、缓存损坏、网络会话僵死或特定文件阻塞所致。以下是解决此问题的步骤：

一、重启iCloud同步核心进程

终止并重新加载bird与cloudd两个关键同步守护进程，可清除其内部挂起状态，强制重建与iCloud服务器的通信链路，不丢失任何本地数据。

1、打开“应用程序” > “实用工具” > “终端”。

2、在终端中依次输入以下命令，每行执行后按回车：
killall bird
killall cloudd

3、等待约10秒，系统将自动拉起新进程，观察菜单栏iCloud图标是否由旋转圆圈变为静态云朵图标。

二、清除iCloud Drive缓存目录

损坏的CloudDocs缓存可能使同步队列陷入不可恢复的停滞，移除该目录将促使系统在下次启动时重建完整同步索引，本地文件不会被删除，仅重置同步元数据。

1、关闭所有正在运行的应用程序，尤其确保“访达”未打开iCloud Drive中的任意文件夹。

2、在“终端”中依次执行以下命令（注意空格与反斜杠）：
killall bird
cd ~/Library/Application\ Support/
mv CloudDocs CloudDocs.backup

3、重启Mac，系统将在登录后自动生成新的CloudDocs文件夹，并开始重新扫描与排队同步任务。

三、检查网络连接与Apple服务状态

iCloud同步依赖稳定TCP连接与Apple后端服务可用性，临时网络抖动或服务端维护会导致上传卡在“小量剩余”状态，需交叉验证两端状况。

1、访问Apple官方系统状态页面：https://www.apple.com/cn/support/systemstatus/，确认“iCloud云盘”项显示为绿色对勾。

2、断开当前Wi-Fi，在“系统设置” > “网络”中切换至有线以太网或另一可信Wi-Fi热点。

3、在“系统设置” > “Apple账户” > “iCloud”中，关闭“iCloud云盘”，等待30秒后再开启，以刷新TLS会话与认证令牌。

四、重置特定阻塞文件同步状态

单个文件（如权限异常、路径过长、含非法字符或已损坏）可能拖住整个同步队列，通过第三方工具可定位并单独重置该条目，避免全盘清理。

1、从EclecticLight官网下载并安装Cirrus for Mac（免费开源工具）。

2、启动Cirrus，选择当前用户账户下的iCloud Drive同步数据库（通常位于~/Library/Caches/com.apple.icloud.fmfd/）。

3、点击“Scan Sync Queue”扫描当前挂起条目，识别出状态为“Stuck”或“Failed”的文件路径。

4、选中对应条目，点击“Reset Sync State”，系统将清除该文件的同步标记并触发重新入队。

五、新建标准用户测试配置冲突

若前述操作均无效，问题可能源于当前用户配置文件损坏（如偏好设置plist异常、扩展冲突或权限继承错误），新建标准用户可隔离验证是否为账户级故障。

1、进入“系统设置” > “用户与群组”，点击左下角锁形图标解锁，输入管理员密码。

2、点击“+”号添加新用户，设置为“标准”类型，不勾选“允许用户管理此电脑”。

3、注销当前账户，以新用户登录，立即前往“系统设置” > “Apple ID” > “iCloud”，仅启用“iCloud云盘”并观察初始同步行为。

4、若新用户下同步正常启动，则原用户配置存在深层损坏，不应直接迁移全部数据，而应逐项恢复文档与偏好设置。