终端可查icloud存储：用icloud-cli工具登录后运行icloud storage --json获取总配额、已用字节及设备同步详情；或通过du和ls分析mobiledocuments目录估算本地缓存；还可用log命令实时监控或检索icloud存储相关日志。
想在Mac终端里直接查iCloud账户当前用了多少空间、剩多少、哪些设备在同步，而不是打开系统设置点来点去——终端命令能绕过图形界面，返回原始数据，适合批量检查或脚本调用。
用iCloud CLI工具获取账户级存储详情
macOS原生不提供icloud存储查询的终端命令，但Apple官方支持的iCloud CLI工具（需单独安装）可直接调用iCloud API。该工具由Apple开发者团队维护，输出JSON格式，含总配额、已用字节、各设备同步状态等字段。
第一步：打开终端，执行brew install icloud-cli安装工具（若未装Homebrew，先运行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）。
第二步：输入icloud login，按提示输入Apple ID和双重认证验证码；登录成功后会生成本地认证令牌，有效期30天。
第三步：运行icloud storage --json，终端立即打印结构化数据——其中"used_bytes"与"total_bytes"字段即为真实占用与总配额，单位字节；"devices"数组列出所有已授权设备名称、最后同步时间及该设备上传的数据量。
注意：若返回401 Unauthorized，说明iCloud两步验证未开启，或Apple ID启用了“隐藏邮件地址”功能，需先在appleid.apple.com中关闭隐私保护选项。
用系统内置命令间接推算iCloud云盘本地缓存占比
当iCloud Drive启用“优化Mac存储”时，部分文件仅保留占位符，终端无法直接读取云端真实大小，但可通过分析本地缓存目录反向估算实际同步量。
执行du -sh ~/Library/MobileDocuments/，该路径存放所有iCloud Drive同步到本机的文档容器，输出值代表当前下载到Mac的全部文件体积（不含占位符）。
再运行ls -la ~/Library/MobileDocuments/ | grep "com~apple~CloudDocs" | wc -l，统计iCloud云盘根目录下可见子项数量；若结果远小于你iCloud中实际文件夹数，说明大量内容仍处于云端未下载状态。
【关键前提】此方法仅对已开启“优化Mac存储”的用户有效；若关闭该选项，MobileDocuments目录将膨胀至与iCloud全量一致，失去参考价值。
解析系统日志中的iCloud存储变更记录
macOS会在后台持续记录iCloud同步事件，包括空间不足警告、自动清理触发、占位符更新等，这些日志比图形界面更早暴露存储异常。
方法一：实时监控最新50条iCloud存储相关日志
在终端输入log stream --predicate 'subsystem == "com.apple.iCloudDrive" && eventMessage contains "storage"' --info | head -50，回车后立即滚动显示最近的存储操作流，如“reclaimed 2.4 GB from iCloud cache”或“quota exceeded, deferring sync”。
方法二：检索过去24小时内的空间告警记录
运行log show --predicate 'subsystem == "com.apple.iCloudDrive" && eventMessage contains "quota"' --last 24h --info，终端将列出所有配额超限事件，含精确时间戳与触发进程名（如cloudd、CloudDocs）。
这一步操作起来很简单，直接把命令复制粘贴进终端回车就行；但要注意，log命令默认只读取过去两天的日志，若需更久远记录，得提前用log config --mode "level:info" --subsystem com.apple.iCloudDrive开启详细日志捕获。
