icloud文件夹权限丢失导致无法同步或下载文件，需恢复~/library/mobile documents及子目录的读写权限，修复继承权限，清除元数据，并重启icloud与访达。
macos中icloud文件夹权限丢失，会导致系统无法写入、同步或下载文件——哪怕网络正常、apple id已登录，你点击云朵图标也一直转圈或提示“网络问题”。这不是网络故障，而是系统拒绝访问本地icloud缓存目录。解决核心是恢复对~/library/mobile documents及子目录（尤其是icloud~com~apple~clouddocs）的完整读写权限。
检查并重置iCloud云盘根目录权限
访达默认隐藏Library文件夹，需先显示：按Command+Shift+G，输入~/Library/Mobile Documents回车。右键该文件夹 → “显示简介” → 展开“共享与权限”，确认你的用户名权限为“读与写”。若显示“无权限”或锁图标锁定：
- 点左下角锁图标，输入管理员密码解锁
- 选中你的用户名，从弹出菜单中选“读与写”
- 点右下角齿轮图标 → “应用到所有子文件夹和文件”
修复桌面与文稿文件夹的继承权限
如果你开启了“iCloud桌面与文稿文件夹”，这两个位置实际是Mobile Documents的符号链接，但权限可能被第三方同步工具（如百度网盘、坚果云）覆盖或中断。进入~/Desktop和~/Documents，同样打开“显示简介”→“共享与权限”：
- 确保你的用户拥有“读与写”且“继承权限”已启用
- 若“继承权限”灰色不可点，先点齿轮 → “使‘xxx’可被管理”再勾选继承
- 特别注意：禁用任何正在同步桌面/文稿的第三方云服务，重启Mac后再试
重建iCloud文档目录所有权（命令行方式）
图形界面有时无法彻底修复深层权限错误。打开“终端”，逐行执行以下命令（复制粘贴，每行回车）：
sudo chown -R $USER:staff ~/Library/Mobile\ Documents sudo chmod -R 755 ~/Library/Mobile\ Documents xattr -rd com.apple.FinderInfo ~/Library/Mobile\ Documents
第三行清除Finder残留的元数据标记，常能解决状态图标不更新、下载卡在“准备中”的问题。
配合重启与账户刷新操作
权限修复后，还需让iCloud进程重新加载配置：
- 前往“系统设置”→“Apple ID”→“iCloud”，关闭“iCloud云盘”，等待10秒再开启
- 退出当前用户，切换至另一个账户（哪怕只是访客），再切回原账户
- 重启“访达”：按
Option+Command+Esc，选“访达”→“重新启动”
