我需要解析 Apple Health XML 才能分析我的锻炼吗?
不需要。Apple Health XML 导出是面向开发者的完整压缩包。如果你只想要锻炼层级的数据,专门的锻炼导出工具可以直接生成 CSV、JSON、GPX、TCX 或 PDF,无需任何解析。
你的 Apple Watch 在每次跑步、骑行和游泳时都记录了大量有用的细节——但要把它导出成一个你真正能打开的文件,却比它本该有的样子更难。这是一份实用指南,教你把 Apple Watch 锻炼数据导出为可供分析、分享或存档的格式,无需搭建任何基础设施。
把锻炼数据从 iPhone 中导出大体有两种方式。一种是开发者路径:解析 Apple 的完整健康压缩包、搭建一条管道、或许还要架起一个小型服务器,然后把结果喂给模型。另一种是实用路径:生成干净的逐次锻炼文件——CSV、GPX、TCX、JSON 或 PDF——并直接使用它们。本文讲的是第二条路径,也是大多数人真正想要的。如果你想快速上手,可以导出 Apple Watch 锻炼数据格式的文件,从而完全省去解析。
Apple 确实允许你导出数据。在“健康”App 中,“导出所有健康数据”会生成一个大型压缩包——主要是 Apple Health XML 导出文件外加单独的路线文件。它内容全面,如果你是想构建自定义工具的开发者,它确实很有用。
但对于普通的锻炼分析来说,它并不顺手。Apple Health XML 导出会把你记录过的每一条健康数据——步数、睡眠、心率、正念等等——都打包进层层嵌套的 XML 中,而 GPS 路线则存为单独的文件。如果你的目标只是一张简单的电子表格、一条 GPX 路线、一个 TCX 文件、一个 JSON 对象,或一页教练报告,那些你都用不上。你需要的是锻炼层级的数据,而不是你的整个健康历史。
大多数锻炼流程每次只需要少数几个字段:
这比“解析我的整个健康压缩包”要小得多,也是值得直接解决的问题。
如果你常用 Excel、Numbers、Google Sheets 或 Python notebook,CSV是最自然的格式。摘要 CSV 为每次锻炼提供一行统计数据;样本 CSV 则提供用于图表和数据透视表的原始时间序列。无需解析,无需插件——直接打开文件即可。请查看将 Apple Watch 导入 Excel的详细教程,了解具体步骤。
大语言模型很擅长读取结构化数据。将一次锻炼导出为CSV或JSON,将其附加到对话中,然后用日常语言提问。JSON 保留的结构最完整;CSV 最便于快速浏览。以下是一些在 ChatGPT 或 Claude 上效果很好的示例提示词:
如果这是你的主要目标,可以查看这篇专门讲解如何用 AI 分析 Apple Watch 锻炼数据会讲得更深入。
和跑步教练、骑行教练、铁三教练、理疗师或私人教练分享数据,通常并不需要原始记录。一份PDF报告——一页之内包含路线地图、摘要卡片、心率图表和统计表格——既易于阅读又便于邮件发送。当教练想把你的训练加载到他们自己的工具中时,CSV 也很合适。
GPX和TCX是基于路线的锻炼的标准便携格式。GPX 携带带有心率的 GPS 轨迹;TCX 则增加了结构化的分段以及踏频、功率等指标。它们适用于绘制地图、存档路线,以及在受支持的情况下导入健身平台。
如果你要换新设备,或想要一份便携的历史记录,可导出的文件会很有帮助。在平台支持的情况下,你可以手动将 GPX 或 TCX 文件上传到 Garmin Connect、Strava 或 TrainingPeaks。字段层级的导入因平台而异,因此最好将其视为手动流程,而非自动同步——这对找回遗漏的活动,或把较早的 Apple Watch 锻炼导入新账户很有用。请参阅将锻炼发送到以下平台的指南:Garmin Connect和Strava。
面向开发者的项目很好地展示了技术层面能做到什么——例如,这个面向开发者的 Apple Health AI 工作流演示了如何用自定义管道把健康数据转化为洞见。如果你要围绕自己的数据构建一套技术系统,这种方法很强大。如果你主要只需要可导出的锻炼文件,这里有一条更简单的途径。
Workout Data Exporter 正是为这个问题的简单版本而生:把 Apple Watch / Apple Health 锻炼导出为你真正能用的文件。它读取你 iPhone 上的锻炼,并将其写为 GPX、TCX、CSV、JSON 和 PDF——无需解析 Apple Health XML 导出文件,无需服务器,无需账户。你可以在以下页面查看完整功能:Workout Exporter网站。
现已在 App Store 上架:App Store 上的 Workout Data Exporter。
根据你想做的事情,有三个诚实的选择:
锻炼和健康数据属于个人隐私。如果你打算把文件上传到 ChatGPT、Claude 或任何第三方服务,请只分享你愿意分享的数据,并先查看该服务的数据处理条款。CSV、JSON 和 PDF 文件天生便携——这正是它们的意义所在——但这也意味着文件一旦离开你的设备,就可能被复制和转发。请像对待任何敏感文档一样谨慎地存储和分享导出文件,并把医疗问题交给合格的专业人士,而不是聊天机器人。
如果你要构建一个完整的健康数据平台,Apple Health XML 导出和开发者工具可能正合适。但如果你只是想把 Apple Watch 锻炼导出为 GPX、TCX、CSV、JSON 或 PDF——用于 AI 分析、电子表格、教练,或手动上传到其他平台——那么专门的锻炼导出工具是更快、更简单的途径。
把任意一次 Apple Watch 或 Apple Health 锻炼转换为 GPX、TCX、CSV、JSON 或 PDF——在设备上完成,一次性购买,无需订阅。看看它如何运作。
在 App Store 下载不需要。Apple Health XML 导出是面向开发者的完整压缩包。如果你只想要锻炼层级的数据,专门的锻炼导出工具可以直接生成 CSV、JSON、GPX、TCX 或 PDF,无需任何解析。
CSV 最易于使用,而 JSON 保留的结构最完整。两者都可以分享给 ChatGPT 或 Claude,以便你索取摘要、趋势和训练报告。只分享你愿意上传的数据。
导出 GPX 或 TCX 文件可以让你获得便携的锻炼文件,在平台支持的情况下手动上传。字段层级的支持因平台而异,因此应将其视为手动流程,而非自动同步。
不会。Apple Health 和 HealthKit 仍是你数据的来源。导出工具只是读取你 iPhone 上的锻炼,并将其写入你可在其他地方使用的文件。