若Mac iCloud Drive长期显示“正在上传”且停滞，可依次执行五步操作：一、终端运行killall bird与cloudd重启同步进程；二、关闭应用后移除CloudDocs缓存并重启；三、检查Apple服务状态、切换网络、重置iCloud云盘开关；四、用Cirrus工具定位并重置阻塞文件；五、新建标准用户测试是否为配置问题。
如果您在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，点击左侧“Sync Status”，查看右侧列表中是否存在标有“Stuck”或“Error”状态的文件条目。
3、选中该条目，点击工具栏“Reset Item”按钮；若提示需要管理员密码，请输入当前用户密码确认。
五、创建新用户测试同步环境
现有用户配置文件中可能混入损坏的偏好设置、扩展冲突或遗留权限策略，新建标准用户可隔离验证是否为系统级配置问题。
1、前往“系统设置” > “用户与群组”，点击左下角锁形图标解锁，输入管理员密码。
2、点击“+”添加新用户，选择“标准”类型，不启用“允许用户管理此电脑”。
3、注销当前账户，以新用户登录，进入“系统设置” > “Apple账户”，仅开启“iCloud云盘”，观察上传状态是否立即开始推进。
