首先重启iCloud同步进程，通过终端执行killall bird与killall cloudd命令；接着重置本地缓存，重命名CloudDocs文件夹并重启；然后检查Apple服务器状态及网络连接是否正常；再重新启用iCloud云盘服务以刷新同步环境；最后确认文件设置为“始终保留在本台Mac上”以确保同步正常。
如果您在使用Mac时遇到iCloud文件无法同步的情况，可能是由于同步进程卡住、缓存数据损坏或网络连接问题导致的。以下是解决此问题的具体步骤：
本文运行环境：MacBook Pro，macOS Sonoma
一、重启iCloud同步进程
终止并重新启动负责iCloud文件同步的核心进程，可以清除临时程序错误，强制系统重建同步连接。
1、打开“应用程序”中的“实用工具”，然后启动“终端”。
2、在终端中输入命令killall bird，按下回车执行。
3、再次输入命令killall cloudd，按下回车执行。
4、等待系统自动重启进程，观察iCloud云盘是否恢复同步。
二、重置本地iCloud云盘缓存
删除本地的同步缓存文件夹可强制系统从云端重新下载最新的文件状态，适用于因缓存损坏导致的同步停滞。
1、关闭所有正在使用的应用程序，确保iCloud相关进程已停止。
2、打开“终端”，依次输入以下命令并执行：cd ~/Library/Application\ Support。
3、接着输入命令：mv CloudDocs CloudDocsOld，将原有缓存文件夹重命名备份。
4、操作完成后，重启电脑或重新登录iCloud账户，系统将创建新的缓存文件夹并开始同步。
三、检查iCloud服务状态与网络连接
确认Apple服务器端是否正常运行，排除因外部服务中断导致的同步失败。
1、打开Safari浏览器，访问https://www.apple.com/cn/support/systemstatus/。
2、查看“iCloud云盘”和“iCloud登录”对应的状态指示灯是否为绿色正常状态。
3、若显示异常，则需等待Apple修复；若显示正常，请继续排查本地网络设置。
4、检查Wi-Fi连接状态，尝试切换网络或重启路由器以排除本地网络故障。
四、重新启用iCloud云盘功能
通过关闭再重新开启iCloud云盘服务，可以刷新整个同步环境，适用于长期不同步或配置错乱的情况。
1、进入“系统设置”，点击顶部的Apple ID头像。
2、选择“iCloud”，向下滚动找到“iCloud云盘”选项并将其关闭。
3、等待几分钟后，重新打开“iCloud云盘”开关，并勾选需要同步的内容。
4、系统将重新初始化同步任务，观察文件是否开始上传或下载。
五、检查文件存储设置
iCloud云盘提供优化存储功能，可能导致部分文件未保留在本地而影响同步状态显示。
1、打开“访达”，在边栏中点击“iCloud云盘”。
2、右键点击需要确保同步的文件或文件夹，选择“始终保留在本台Mac上”。
3、该设置会防止系统自动卸载本地副本，确保文件状态可见且参与同步。
