将 Apple 健康数据同步到 iCloud 云盘
将健康数据同步到 iCloud 云盘以便随时访问。
Last updated: May 6, 2026
本页目录
iCloud 云盘自动化可将健康数据自动保存到 iCloud 云盘。文件直接保存在 iCloud 云盘中,可在登录同一 iCloud 账户的任意设备上访问。
概述
iCloud 云盘自动化会按自动化名称组织文件夹结构,将健康数据自动保存到 iCloud 云盘。文件按日期范围(日、周、月或年)组织,可导出为 JSON 或 CSV。
适用场景:
- 自动备份到 iCloud 云盘
- 在多台 Apple 设备上访问健康数据
- 简单、无需额外登录的备份方案
- 长期归档
主要功能:
- 支持 JSON 与 CSV
- 无需单独身份验证流程
- 直接文件系统访问
- 在 Apple 设备间顺畅使用
限制
健康数据访问: iPhone 锁定时应用无法访问健康数据。自动化仅在设备解锁期间运行,可能影响数据新鲜度。请参阅手动同步说明以保持数据最新。
后台处理: 为节省电量,iOS 会限制后台处理。自动化依赖“后台 App 刷新”,在以下情况可能不会立即运行:
- 已为该应用关闭后台 App 刷新
- 设备处于低电量模式
- 设备长时间未活动
- 系统资源紧张
- 多个应用竞争后台执行时间
前提条件
- Apple ID / iCloud 账户
- 设备已启用 iCloud 云盘
- 足够的 iCloud 存储空间
- 应用已获 iCloud 云盘访问权限
配置
在主界面导航至“自动导出”屏幕,轻点“New Automation”,并将自动化类型选为“iCloud Drive”。
自动化名称
输入易于识别的名称(例如 “Daily Health Backup”、“Weekly Health Export”)。该名称将用作 iCloud 云盘中的文件夹名称。
说明: 文件夹将创建在应用 iCloud 容器中的 Documents/{automation_name}/。
通知
选择何时接收通知:
- Notify on Cache Update — 缓存数据更新时通知
- Notify When Run — 每次自动化保存数据时通知
iCloud 云盘设置
iCloud 云盘自动化无需额外身份验证。应用会自动使用设备上的 iCloud 账户。
要求:
- 设备必须已登录 iCloud
- 必须启用 iCloud 云盘
- 应用必须有权访问 iCloud 云盘
确认 iCloud 云盘访问:
- 前往 设置 > [您的姓名] > iCloud
- 确认已启用 iCloud 云盘
- 应用将自动使用您的 iCloud 账户
说明: 若未登录 iCloud 或未启用 iCloud 云盘,自动化将无法工作。
自定义文件名
对于 iCloud Drive 自动化,你可以选择性地设置自定义文件名前缀。
- 若留空,导出会使用默认命名。
- 若已设置,该前缀会用于 JSON 文件,并加在 CSV 样式名称的前面。
- 不适用于文件名的字符会被自动清理。
前缀示例:
HealthBackupDailyExportCustomName
数据类型设置
数据类型
选择要导出的健康数据类型:
- Health Metrics — 步数、心率、睡眠等测量值
- Workouts — 运动与健身活动
- Symptoms — 症状与状况
- ECG — 心电图记录
- Heart Rate Notifications — 心率过高/过低事件
- State of Mind — 情绪与心理状态记录(iOS 18.0+)
- Cycle Tracking — 月经周期与生殖健康数据
- Medications — 用药记录与依从性(iOS 26.0+)
Health Metrics 配置
选择 Health Metrics 时:
Select Health Metrics — 选择要包含的指标,可选全部或部分。
提示: 仅选择需要的指标可减小文件体积并加快处理。
Preferred Sources — 当多个来源提供同一指标时,设置优先来源。
Workout 配置
选择 Workouts 时:
Include Route Data — 若运动包含位置数据,打开以包含路线。
Include Workout Metrics — 打开以包含运动期间采集的指标(心率、卡路里等)。
Time Grouping (Workout Metrics) — 使用导出版本 2 且启用 Include Workout Metrics 时:
- Minutes — 按分钟汇总运动指标
- Seconds — 按秒汇总运动指标
导出设置
导出格式
选择导出格式:
JSON format — 嵌套对象结构,适合应用、数据库与详细分析;对睡眠阶段、房颤等复杂类型信息更完整。
CSV format — 表格数据,可导入 Excel、Numbers 等电子表格或其他工具。
提示: 全面存储用 JSON,在表格软件中查看用 CSV。
Export Version
选择导出版本。版本化可按您自己的节奏升级,减少对现有流程的冲击。
- Version 1 — 旧版格式,若现有流程依赖此格式请使用
- Version 2 — 当前格式,包含更丰富的运动数据与元数据选项
Date Range
选择如何按文件组织数据:
- Day — 每天单独文件
- Week — 每周单独文件
- Month — 每月单独文件
- Year — 每年单独文件
文件组织:
- 文件保存在 iCloud 云盘中的
Auto Export/{automation_name}/ - 文件名反映所包含的日期范围
- 每个文件包含该时段内的全部数据
Summarize Data
对 JSON 且数据类型为 Health Metrics 时,可打开或关闭 Summarize Data。
- 打开 — 提供汇总数据(默认)
- 关闭 — 在可能的情况下提供非汇总、逐点数据
说明: 仅适用于 JSON + Health Metrics。使用 CSV 或选择多项指标时,数据始终为汇总形式。
Time Grouping
选择文件内数据的汇总粒度。可选范围取决于所选的 Date Range。
说明: 更细粒度(分钟/小时)文件更大、细节更多;较粗粒度(日/周/月)文件更小、为摘要数据。
同步频率
设置自动化向 iCloud 云盘保存数据的频率:
选择数字与时间单位。
测试与验证
手动测试
- 在自动化配置界面轻点 “Manual Export”
- 选择日期范围
- 轻点 “Export” 保存文件
- 在 iCloud 云盘文件夹中确认文件已保存
在 iCloud 云盘中核对文件
- 打开“文件”应用(iOS)或 Finder(macOS)
- 前往 iCloud 云盘 > Health Auto Export > [您的自动化名称]
- 确认文件名与日期符合预期
- 打开文件确认数据正确
查看活动日志
- 在自动化配置界面轻点 “View Activity Logs”
- 查看近期运行记录
- 检查保存错误或 iCloud 云盘问题
- 核对保存时间戳
访问文件
打开 iCloud 云盘文件夹
- 在自动化配置界面(“帮助与故障排除”下)轻点 “Open iCloud Drive”
- 会在“文件”应用中打开该自动化的文件夹
- 可直接浏览与管理文件
文件位置
文件保存在:
iCloud 云盘 > Health Auto Export > {automation_name}/
在 iOS 上访问:
- 使用“文件”应用
- 进入 iCloud 云盘
- 找到 “Health Auto Export” 文件夹
- 打开您的自动化文件夹
在 macOS 上访问:
- 打开 Finder
- 进入 iCloud 云盘
- 找到 “Health Auto Export” 文件夹
- 打开您的自动化文件夹
通过 iCloud.com 访问:
- 登录 iCloud.com
- 打开 iCloud 云盘
- 找到 “Health Auto Export” 文件夹
- 按需下载文件
故障排除
常见问题
iCloud 云盘中看不到文件
- 确认已登录 iCloud
- 在“设置”中确认已启用 iCloud 云盘
- 确认自动化至少运行过一次
- 尝试轻点 “Open iCloud Drive” 打开文件夹
- 在活动日志中查看保存错误
iCloud 云盘同步问题
- 确认网络连接正常
- 在“设置”中查看 iCloud 云盘同步状态
- 确认有足够 iCloud 存储空间
- 等待同步完成(可能需要数分钟)
- 最后手段:退出并重新登录 iCloud
“Folder does not appear to exist” 错误
- 确认自动化至少运行过一次
- 运行一次手动导出以创建文件夹
- 确认 iCloud 云盘已启用且正在同步
- 确认登录的是同一 iCloud 账户
保存失败
- 检查网络连接
- 确认 iCloud 存储空间充足
- 在活动日志中查看具体错误信息
- 尝试手动导出以测试 iCloud 云盘访问
- 确认已为应用启用 iCloud 云盘
跨设备不同步
- 确认所有设备登录同一 iCloud 账户
- 在各设备上检查 iCloud 云盘同步状态
- 等待同步完成(可能需要较长时间)
- 确认各设备均已启用 iCloud 云盘
- 检查可用 iCloud 存储空间
错误信息
在以下情况应用会显示错误:
- 未启用 iCloud 云盘
- 未登录 iCloud
- iCloud 存储空间不足
- iCloud 云盘同步失败
- 文件保存错误
请在活动日志中查看详细错误信息。
提示与最佳实践
自动同步:
- 为设备充电并使用 iPhone 镜像
- 充电时 iOS 对性能限制较少,数据可更频繁同步
- 使用镜像时设备行为类似已解锁,Health Auto Export 可访问健康数据以运行自动化
- 为设备充电并使用 iPhone 镜像
文件格式:
- 全面存档用 JSON
- 在表格软件中查看用 CSV
- 按使用场景选择格式
数据选择:
- 只选需要的指标以减小体积
- 可按指标分组创建多个自动化
- 便于整理并减小单文件大小
存储管理:
- 关注 iCloud 存储用量
- iCloud 免费提供 5GB(可升级)
- 需要时可升级 iCloud 存储
- 可将旧文件归档以释放空间
跨设备访问:
- 文件会在所有 Apple 设备间自动同步
- 可在 iPhone、iPad、Mac 与 iCloud.com 访问
- iOS 使用“文件”,macOS 使用 Finder
- 首次同步后也可离线访问文件
安全性:
- 使用您 iCloud 账户的安全机制
- 关注 iCloud 隐私设置
- 文件仅对您 iCloud 账户可见
与 macOS 协同:
- 可直接在 Finder 中访问
- 使用可读取 JSON/CSV 的 macOS 应用
- 可在 macOS 上设置文件夹操作或自动化
- 需要时可用终端处理文件
文件管理:
- 使用“文件”应用整理文件
- 需要时可手动创建子文件夹
- 删除旧文件以释放空间
- 可使用标签便于整理