mac本地磁盘空间异常占用大概率由icloud“桌面与文稿文件夹”同步引发，表现为全量下载、重复缓存或权限异常；需先验证图标状态与终端容量对比，再关闭同步并选“保留在我的mac上”，随后清理clouddocs缓存、cloudkit临时文件及修正权限。
Mac本地磁盘空间突然告急，桌面和文稿文件夹里的内容明明没变多，却占满几十GB——大概率是iCloud“桌面与文稿文件夹”同步在后台全量下载、重复缓存或权限异常导致的。这不是系统坏了，而是同步机制和本地存储策略没对齐。
确认是否真由iCloud同步引发
先快速验证问题根源，避免误操作：
- 打开访达 → 左侧边栏点“iCloud云盘”，观察“桌面”和“文稿”文件夹图标右下角是否有蓝色向下箭头（表示已完整下载）；
- 终端执行：
ls -la ~/Desktop ~/Documents，若显示大量文件且du -sh ~/Desktop ~/Documents结果远超你实际存放量（比如显示25GB但你只存了3个PDF），基本可锁定为同步冗余； - 进入“系统设置 → Apple ID → iCloud → iCloud云盘”，检查“桌面与文稿文件夹”开关是否开启——开着就继续排查，关着却仍有占用，则可能是残留缓存或第三方工具干扰。
关闭同步并保留本地文件
这是最直接有效的止损动作，关键在选对选项，避免误删：
- 点击苹果菜单 → “系统设置” → 左侧你的Apple ID → 右侧“iCloud” → “iCloud云盘”；
- 向下滚动找到“桌面与文稿文件夹”，将右侧开关拖至关闭（灰色）；
- 弹出提示时，必须点选“保留在我的Mac上”——选“从Mac中移除”会清空本地桌面和文稿，不可逆；
- 关闭后，再进访达确认 ~/Desktop 和 ~/Documents 仍可正常打开、文件完整，说明本地接管成功。
清理同步残留与缓存
即使关闭同步，iCloud仍可能留有临时文件、占位符或损坏缓存，它们不显示在访达里，却真实占用空间：
-
清CloudDocs缓存：访达 →「前往」→「前往文件夹…」→ 输入
~/Library/Application Support/CloudDocs→ 删除整个文件夹（系统重启后会重建）； -
删隐藏临时文件：同样方式进入
~/Library/Caches/CloudKit/，删除含upload、download、staging的子目录； - 移除iCloud云盘边栏残留：访达 →「前往」→「偏好设置」→「边栏」→ 取消勾选“iCloud云盘”，减少视觉干扰；
- 终端执行：
defaults write NSGlobalDomain NSDocumentSaveNewDocumentsToCloud -bool false，阻止新建文档默认存iCloud，从源头减负。
验证路径归属与权限是否正常
权限丢失会导致iCloud反复尝试写入失败，触发重试机制，不断生成临时副本，最终撑爆磁盘：
- 访达中右键 ~/Desktop → “显示简介” → 展开“共享与权限”，确认当前用户权限为“读与写”，且没有“不能读取”字样；
- 同理检查 ~/Documents 和 ~/Library/Application Support/CloudDocs；
- 若权限异常，终端执行：
sudo chown -R $(whoami) ~/Desktop ~/Documents ~/Library/Application\ Support/CloudDocs； - 完成后重启bird和cloudd进程：
killall bird; killall cloudd，让同步服务以新权限重新初始化。
排查完这几步，本地空间通常能立刻释放10–50GB，且同步不再偷偷吃磁盘。重点不是删文件，而是让iCloud和本地目录各司其职——该同步的同步，该留本地的留本地，该清理的清理干净。
