要完整下载icloud照片图库原始文件到mac本地，首选“照片”app中启用“将原片下载到此mac”；其次可批量导出选定内容为未修改原片；还可使用icloudpd命令行工具实现结构化、增量式全量拉取。
你需要把iCloud照片图库里每一张原始高清照片和视频，不压缩、不转码、不删减地完整下载到Mac本地硬盘，确保离线也能随时打开编辑——这要求彻底关闭优化策略，强制系统拉取并永久保留在本地的全分辨率副本。
通过“照片”App设置启用原片全量下载
这是最直接、最系统级的方案，适用于希望整个图库100%落地、后续持续同步也保持本地全量存储的用户。操作后，“照片”App将不再依赖网络加载原图，所有缩略图背后都对应真实文件。
1、打开Mac上的“照片”App，确保已用你的Apple ID登录且iCloud照片已开启。
2、点击菜单栏【照片】→【设置】→ 切换到【iCloud】标签页。
3、在“iCloud照片”区域下方，点击【将原片下载到此Mac】按钮。
4、系统开始后台下载，进度条显示在按钮位置；下载期间可正常使用Mac，但【本地可用空间必须大于图库原始总大小】，否则中途会卡住或失败——你可在“照片”→“关于”中查看当前图库估算大小。
批量导出选定内容为未修改原片
如果你只要部分照片（比如近一年的旅行照、某个相册），又要求文件独立于“照片图库”数据库、保留原始格式（HEIC/JPEG/RAW/MOV）和完整EXIF信息，就用这个方法。
方法一：按相册或时刻筛选后导出
1、在左侧边栏点击目标相册，或进入“时刻”视图手动拖选时间范围。
2、按Command+A全选当前视图所有项目；若数量过大（如超5000张），建议分批操作，避免导出过程因内存不足中断。
3、右键任意选中项 →【导出】→【导出未修改的原片】。
4、在弹出窗口中，务必指定保存路径为【非iCloud云盘内的任意本地文件夹】，例如“外部硬盘/我的备份/2026旅行原片”，否则可能触发iCloud云盘二次同步冲突。
用icloudpd命令行工具实现无人值守全量拉取
当你需要绕过“照片”App数据库限制、获取原始文件结构（按年/月/日自动建文件夹）、支持Live Photo拆分为图片+视频、且能跳过已存在文件做增量续传时，icloudpd是目前最可靠的开源选择。
① 安装与首次认证
打开终端，执行：pip install icloudpd；若提示pip版本过旧，请先运行python -m pip install --upgrade pip。
② 创建专属下载目录并进入：
mkdir -p ~/Desktop/iCloud全量备份 && cd ~/Desktop/iCloud全量备份
③ 启动登录流程（会自动打开浏览器或提示输入验证码）：
icloudpd --directory . --username your_apple_id@domain.com --size original
⚠️注意：若Apple ID启用了双重认证，必须提前在appleid.apple.com生成一个【应用专用密码】，并在终端提示输入密码时粘贴该密码，而非你的账户主密码。
④ 认证成功后，执行全量下载命令：
icloudpd --directory . --username your_apple_id@domain.com --size original --auto-delete --recent 0
该命令含义：下载全部历史照片（--recent 0表示不限制天数），保留原始尺寸，下载完成后自动从iCloud移除已成功拉取的项目（--auto-delete可选，仅用于迁移场景）。
