将 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 样式名称的前面。
  • 不适用于文件名的字符会被自动清理。

前缀示例:

  • HealthBackup
  • DailyExport
  • CustomName

数据类型设置

数据类型

选择要导出的健康数据类型:

  • 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 云盘保存数据的频率:

选择数字与时间单位。

测试与验证

手动测试

  1. 在自动化配置界面轻点 “Manual Export”
  2. 选择日期范围
  3. 轻点 “Export” 保存文件
  4. 在 iCloud 云盘文件夹中确认文件已保存

在 iCloud 云盘中核对文件

  1. 打开“文件”应用(iOS)或 Finder(macOS)
  2. 前往 iCloud 云盘 > Health Auto Export > [您的自动化名称]
  3. 确认文件名与日期符合预期
  4. 打开文件确认数据正确

查看活动日志

  1. 在自动化配置界面轻点 “View Activity Logs”
  2. 查看近期运行记录
  3. 检查保存错误或 iCloud 云盘问题
  4. 核对保存时间戳

访问文件

打开 iCloud 云盘文件夹

  1. 在自动化配置界面(“帮助与故障排除”下)轻点 “Open iCloud Drive”
  2. 会在“文件”应用中打开该自动化的文件夹
  3. 可直接浏览与管理文件

文件位置

文件保存在:

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 云盘同步失败
  • 文件保存错误

请在活动日志中查看详细错误信息。

提示与最佳实践

  1. 自动同步:

    • 为设备充电并使用 iPhone 镜像
      • 充电时 iOS 对性能限制较少,数据可更频繁同步
      • 使用镜像时设备行为类似已解锁,Health Auto Export 可访问健康数据以运行自动化
  2. 文件格式:

    • 全面存档用 JSON
    • 在表格软件中查看用 CSV
    • 按使用场景选择格式
  3. 数据选择:

    • 只选需要的指标以减小体积
    • 可按指标分组创建多个自动化
    • 便于整理并减小单文件大小
  4. 存储管理:

    • 关注 iCloud 存储用量
    • iCloud 免费提供 5GB(可升级)
    • 需要时可升级 iCloud 存储
    • 可将旧文件归档以释放空间
  5. 跨设备访问:

    • 文件会在所有 Apple 设备间自动同步
    • 可在 iPhone、iPad、Mac 与 iCloud.com 访问
    • iOS 使用“文件”,macOS 使用 Finder
    • 首次同步后也可离线访问文件
  6. 安全性:

    • 使用您 iCloud 账户的安全机制
    • 关注 iCloud 隐私设置
    • 文件仅对您 iCloud 账户可见
  7. 与 macOS 协同:

    • 可直接在 Finder 中访问
    • 使用可读取 JSON/CSV 的 macOS 应用
    • 可在 macOS 上设置文件夹操作或自动化
    • 需要时可用终端处理文件
  8. 文件管理:

    • 使用“文件”应用整理文件
    • 需要时可手动创建子文件夹
    • 删除旧文件以释放空间
    • 可使用标签便于整理