mac同步文件提示“空间不足”实为假性不足，主因是time machine本地快照、clouddocs过期文件及apfs未分配空间占用，需依次用系统储存管理工具释放8gb+、终端清理快照（5–12gb）、扩容apfs容器、手动清clouddocs过期文件、启用icloud优化并强制同步刷新。
Mac同步文件时提示“空间不足”，常因iCloud同步进程被本地磁盘碎片化占用、Time Machine快照锁死可用空间、或CloudDocs中堆积大量过期临时文件所致；系统判定连续可用空间低于阈值，即使总剩余超20GB也会中断同步。
先用系统储存管理工具快速释放基础空间
这一步调用macOS内置识别逻辑，只清理系统明确标记为“可重建、无副作用”的缓存与日志，不删用户数据也不动系统关键文件，安全且见效快。
点击屏幕左上角苹果图标→「系统设置」→「通用」→「储存空间」，等待15秒左右完成扫描。
点击右侧「管理」按钮，在弹出窗口中依次处理「缓存文件」「日志文件」「旧文件」，对每项执行「删除」或「优化」。
开启「优化储存空间」开关：自动移除已观看的Apple TV影片、仅保留最近邮件附件；同时启用「自动清倒废纸篓」，设定为清除存放超30天的项目。
强制清理iCloud同步残留的过期文件
macOS 26新增通用控制增强与实时协作功能，导致~/Library/Application Support/Apple/CloudDocs中产生大量标有“已过期”的同步临时文件，这些文件无法被系统自动回收，需主动识别清理，否则长期驻留并持续膨胀。
按Command+Shift+G打开“前往文件夹”，输入：~/Library/Application Support/Apple/CloudDocs，回车进入。
按修改日期排序，筛选出名称含【expired】、【obsolete】或创建时间早于90天的文件/文件夹。
选中后直接拖入废纸篓——这类文件不参与任何当前同步链路，删除后不会触发重同步或数据丢失。
精准删除本地Time Machine快照释放隐藏空间
这些快照在访达不可见、储存空间界面也不单独列出，但真实占用磁盘——而且iCloud同步时会把它当“不可动空间”计算，是导致同步中断的最常见原因。
方法一（推荐温和清理）：打开「终端」→输入命令sudo tmutil thinlocalsnapshots / --keep-alive 1→回车后输入管理员密码。该命令优先清除最老快照，保留最新一个用于恢复，通常释放5–12GB。
方法二（确认存在后精准删除）：先运行tmutil listlocalsnapshots /查看快照列表；若返回类似com.apple.TimeMachine.2026-05-12-094721的条目，再逐条执行sudo tmutil deletelocalsnapshots 2026-05-12-094721（时间戳需替换为实际值）。
⚠️ 注意：com.apple.os.update开头的快照千万别删——那是你当前系统的只读副本，删了可能导致无法启动。
检查并扩容APFS容器未分配空间
部分Mac在磁盘分区后存在未分配给APFS容器的物理空间，iCloud同步程序无法使用这部分区域，需手动纳入主卷宗。
第一步：打开「磁盘工具」→左侧边栏选择顶层磁盘（如「APPLE SSD AP0256J」），不是其下的「容器」或「卷宗」。
第二步：点击顶部「信息」按钮→查看「可用」与「未分配」数。
第三步：若「未分配」大于0GB，选中顶层磁盘→点击右上角「编辑」→「添加容量」→拖动滑块将全部未分配空间划入「Macintosh HD」容器→点击「应用」。
启用iCloud优化并强制同步状态刷新
iCloud同步卡在“空间不足”常因本地元数据与云端状态不同步，需手动触发状态重置。
打开「系统设置」→「Apple ID」→「iCloud」→关闭「iCloud 云盘」开关，等待30秒。
重新开启「iCloud 云盘」→点击右侧「选项」→勾选「桌面与文稿文件夹」→确保「在Mac上保留副本」已启用。
打开访达→顶部菜单「前往」→「前往文件夹」→输入~/Library/Mobile Documents→右键「显示简介」→确认「已使用」数值开始缓慢下降，表明同步队列已重启。
