首先重启iCloud同步进程，通过终端执行killall bird和killall cloudd命令；若无效则清除缓存，关闭应用后在终端运行相关命令并重启Mac；同时检查网络及Apple服务状态，必要时切换网络或重置iCloud云盘；可借助Cirrus工具诊断同步错误并重置卡住文件；最后创建新管理员账户测试，排除用户配置问题。
如果您在使用Mac的iCloud云盘时，发现文件上传进度长时间停滞在“正在上传”或“等待上传”状态，导致文件无法同步到其他设备，可能是由于同步进程异常或缓存数据错误所致。以下是解决此问题的具体方法。
本文运行环境：MacBook Pro，macOS Sequoia
一、重启iCloud同步进程
通过终止并重新启动负责iCloud同步的核心进程，可以清除临时卡死状态，强制系统重建连接。
1、打开“应用程序”中的“终端”工具。
2、依次输入以下命令，并在每条命令后按回车执行：killall bird 和 killall cloudd。
3、等待几秒钟，系统会自动重启这两个进程，此时观察iCloud云盘的上传状态是否恢复。
二、清除iCloud云盘缓存文件
缓存文件损坏可能导致同步任务无法推进，删除缓存可让系统重新生成同步队列，但不会影响本地已保存的文件。
1、关闭所有正在使用的应用程序，确保iCloud未进行任何同步操作。
2、打开“终端”，依次执行以下命令：
killall bird
cd ~/Library/Application\ Support/
mv CloudDocs CloudDocs.backup
3、重启Mac，系统会自动创建新的CloudDocs文件夹并开始重新同步。
三、检查网络连接与服务状态
不稳定的网络或Apple服务器端问题会导致上传中断，需确认当前网络环境及iCloud服务是否正常。
1、访问Apple官方系统状态页面 https://www.apple.com/cn/support/systemstatus/，查看iCloud云盘服务是否显示为绿色正常状态。
2、尝试切换至其他Wi-Fi网络，或使用有线连接排除本地网络故障。
3、在“系统设置”中暂时关闭iCloud云盘，等待30秒后再重新开启以刷新网络会话。
四、使用第三方工具诊断同步状态
借助专用工具可以更直观地查看iCloud同步队列和错误日志，便于定位具体问题文件或进程。
1、下载并安装Cirrus for Mac，该工具由EclecticLight开发，专用于管理iCloud Drive同步。
2、运行Cirrus，查看“Sync Status”面板中是否有标记为“Error”或“Stuck”的项目。
3、选择卡住的文件条目，点击“Reset Item”按钮重置其同步状态。
五、创建新管理员账户测试
排除当前用户配置文件损坏的可能性，通过新建账户判断是否为系统级问题。
1、进入“系统设置” > “用户与群组”，点击左下角锁图标并输入密码解锁。
2、点击“添加账户”，选择“管理员”，设置新用户名和密码。
3、退出当前账户，使用新建的管理员账户登录。
4、在新账户中登录Apple ID并启用iCloud云盘，测试上传功能是否恢复正常。
