HealthyApps Help Center

将 Apple 健康数据同步到 iCloud 云盘

将健康数据同步到 iCloud 云盘以便随时访问。

Last updated: May 20, 2026

本页目录

iCloud 云盘自动化指南

iCloud 云盘自动化可将健康数据自动保存到 iCloud 云盘。文件直接保存在 iCloud 云盘中，可在登录同一 iCloud 账户的任意设备上访问。

概述

iCloud 云盘自动化会按自动化名称组织文件夹结构，将健康数据自动保存到 iCloud 云盘。文件按日期范围（日、周、月或年）组织，可导出为 JSON 或 CSV。

适用场景：

  • 自动备份到 iCloud 云盘
  • 在多台 Apple 设备上访问健康数据
  • 简单、无需额外登录的备份方案
  • 长期归档

主要功能：

  • 支持 JSON 与 CSV
  • 无需单独身份验证流程
  • 直接文件系统访问
  • 在 Apple 设备间顺畅使用

限制:

  • 健康数据访问： iPhone 锁定时，App 无法访问健康数据。自动化仅在设备解锁期间运行。这是 Apple 施加的限制，无法绕过。更多信息
  • 后台处理： iOS 为节省电量会限制后台处理。自动化依赖“后台 App 刷新”，在以下情况下可能不会立即运行：
    • 已为该 App 关闭“后台 App 刷新”
    • 设备处于低电量模式
    • 设备长时间未活动
    • 系统资源紧张
    • 多个 App 竞争后台执行时间

前提条件

  • Apple ID / iCloud 账户
  • 设备已启用 iCloud 云盘
  • 足够的 iCloud 存储空间
  • 应用已获 iCloud 云盘访问权限

配置

在主界面导航至“自动导出”屏幕，轻点“New Automation”，并将自动化类型选为“iCloud Drive”。

自动化名称

输入易于识别的名称（例如 “Daily Health Backup”、“Weekly Health Export”）。该名称将用作 iCloud 云盘中的文件夹名称。

说明： 文件夹将创建在应用 iCloud 容器中的 iCloud Drive/AutoExport/{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 云盘中的 AutoExport/{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 云盘 > AutoExport > [您的自动化名称]
  3. 确认文件名与日期符合预期
  4. 打开文件确认数据正确

查看活动日志

  1. 点按 查看活动日志 自动化配置屏幕中的.
  2. 事件按运行分组（最新运行在上）。展开某次运行可查看各事件。
  3. 区分警告（例如健康数据查询缓慢）和错误 (iCloud 保存或编码失败)—参见 自动化概览 — 活动日志.
  4. 检查每次运行的写入/保存成功行和错误详情。
  5. 共享（工具栏）导出完整的 App 事件日志诊断 ZIP，与设置 → 高级 → 导出事件日志相同。参见 App 事件日志指南。
  6. 清除（工具栏）仅删除该自动化的活动历史，不会删除 App 范围内的诊断日志。

访问文件

打开 iCloud 云盘文件夹

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

文件位置

文件保存在：

iCloud 云盘 > AutoExport > {automation_name}/

在 iOS 上访问：

  • 使用“文件”应用
  • 进入 iCloud 云盘
  • 找到 “AutoExport” 文件夹
  • 打开您的自动化文件夹

在 macOS 上访问：

  • 打开 Finder
  • 进入 iCloud 云盘
  • 找到 “AutoExport” 文件夹
  • 打开您的自动化文件夹

通过 iCloud.com 访问：

  • 登录 iCloud.com
  • 打开 iCloud 云盘
  • 找到 “AutoExport” 文件夹
  • 按需下载文件

故障排除

常见问题

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. 文件管理：

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