用 brctl 把 iCloud 云盘文件下载到本地
让隐藏的 iCloud 同步进程按需取回文件内容。
运行 `brctl download /iCloud/云盘内路径` 强制文件完整下载到磁盘。
01命令
命令
$ brctl download "$HOME/Library/Mobile Documents/com~apple~CloudDocs/报告.pdf"02作用说明
iCloud 云盘中显示的文件可能只是占位符，只有打开时才真正下载，这会导致脚本直接读取路径时失败。`brctl` 与 iCloud 云盘守护进程 `bird` 通信，`download` 可以在不打开应用的情况下把真实内容拉到本地。可用 `brctl monitor` 或 `brctl dump` 的状态列查看进度。
03风险
!注意: 只有 `~/Library/Mobile Documents` 下的路径才属于 iCloud 云盘；批量下载会消耗流量和磁盘空间；此命令只是取回数据，无需撤销。
04撤销
✓无需撤销——该命令不会改变持久状态。
05来源
- brctl(8) – bird control utility依据: Manual page documenting brctl download/monitor/dump for the iCloud document store
最后验证: 2026-09-18 · 分类: 文件与文件夹