不知道你有没有这种经历:收藏了一堆健身教程,真正想找某个动作时,还是得重新搜。名字记不住,器械对不上,点开视频还要拖进度条。如果想做一个自己的健身小程序,麻烦更多——动作名称、图片、文字说明,全得一点点整理。
最近在 云栈社区 看到不少人聊到这个痛点,正好 GitHub 上有个项目把这事解决了大半。这个叫 exercises-dataset 的 开源 项目,把 1,324 个健身动作 整理成了一份资料库,动作演示、肌肉分类、器械信息和多语言说明,都放在了一起。

项目简介
exercises-dataset 是一套结构化健身动作数据,也是训练记录应用 LogPress 使用的动作数据层。
说得通俗一点,它像一本能被程序直接读取的“健身动作字典”。每个动作都有固定编号、名称、训练部位、目标肌肉、所需器械,还有缩略图和 GIF 动图。

杠铃卧推 · 动作资料库中的演示素材 © Gym visual — https://gymvisual.com/
普通用户可以用它查动作,开发者可以拿它搭动作库、训练记录页面或健身应用原型。不过它本身提供的是动作资料,训练计划和推荐逻辑还需要另外设计。
动作能动起来,比只看名字直观
看到“哑铃弯举”这几个字,你可能有印象;换成一个不熟悉的动作,单靠名称就很难理解。
这个项目给每个动作配了 180×180 的缩略图和动画 GIF。列表里先看小图,点进详情再看运动过程,文字和演示能对得上。

哑铃弯举 · GIF 保留动作过程 © Gym visual — https://gymvisual.com/
它的图片尺寸不大,更适合动作卡片、资料索引和应用列表。想拿来做高清海报、全屏教学视频,就不太合适了。
按器械和肌肉筛选,少翻很多页
如果手里只有一副哑铃,面对上千个动作挨个找,肯定不现实。项目自带的浏览页面支持按类别、器械和目标肌肉筛选,也能搜索动作。先选器械,再缩小到想了解的部位,查资料的路径就清楚多了。
| 器械分类 |
动作数量 |
| 自重 |
325 |
| 哑铃 |
294 |
| 绳索器械 |
157 |
| 杠铃 |
154 |
| 弹力带 |
54 |
这里有个小细节值得注意:“自重”不代表完全不需要器械。 比如引体向上属于自重动作,但仍然要用到单杠。筛选完,还是得看具体动作。

引体向上 · 自重分类下的动作示例 © Gym visual — https://gymvisual.com/
中文说明也有,不用对着英文硬猜
当前数据文件包含中文、英文、西班牙文等 10 种语言 的动作说明。打开动作详情,可以切换语言阅读。
除了整段文字,数据里还提供拆好的步骤数组。开发者做手机页面时,就能把说明一条条展示出来,阅读起来比挤成一大段舒服。
同一个动作的不同语言说明放在同一条记录里。切换语言时,不用重新找另一份文件,也不用自己把十份资料重新配对,这对做多语言版本的应用很方便。
需要分清的是,多语言主要体现在动作说明上,不能理解成所有动作名称和界面都已经完整汉化。正式做中文产品时,名称、术语和译文仍然值得校对一遍。
做健身应用,省掉从零整理资料的功夫
对开发者来说,真正省事的是这些信息已经按统一字段整理好了。主数据放在 data/exercises.json,程序读取后就能筛选、分组、展示。仓库还提供字段规范,方便检查数据格式,后续添加动作也有章可循。
配套的 setup.html 更像一个接入向导:可以查看数据库建表方案、生成导入 SQL,还有多种语言的接口调用示例。
比如先做一张动作卡片:标题放名称,下方显示器械和目标肌肉,详情页再放动图与中文步骤。把资料展示跑通后,再添加收藏、训练记录等功能,整个开发思路就有了落点。
它也准备了让 AI 辅助生成后端的提示词模板。不过这些是开发辅助材料,实际 API 仍然需要自己搭建、测试和部署。
快速下载、使用
不写代码也能先看起来。在项目页面点击 Code → Download ZIP,下载后完整解压,双击根目录的 index.html,就能用浏览器查看动作库。
记得保留 images 和 videos 文件夹与页面的相对位置,单独拷走 HTML 会影响图片和动图显示。
会用 Git 的朋友,也可以直接下载整个仓库:
git clone https://github.com/hasaneyldrm/exercises-dataset.git
有一点要提前说清:代码和非媒体数据采用 MIT 许可,动作图片与 GIF 的版权属于 Gym visual,另有授权条款。把素材放进自己的产品前,需要确认适用许可,保留版权标识,不能把仓库开源等同于图片随便商用。
最后聊两句
exercises-dataset 的价值,在于把散落的动作资料整理成了能查、能筛选、能接进程序的格式。
它不会替你判断该练什么、练多重,也不能代替动作指导。但如果你想搭一个自己的动作资料库,或者正准备做健身工具,这份现成的数据能省下不少整理时间。
先打开浏览页面,找几个熟悉的动作看看。能不能用得上,很快就有答案。
项目地址: https://github.com/hasaneyldrm/exercises-dataset