🚀
快速生成
从 Swagger JSON 快速生成 TS/JS 接口代码，一行命令跑通「配置 → 生成 → 调用」。
Swagger 转 APISwagger 文档一键转 TS/JS API
基于 swagger-typescript-api 封装的 CLI 工具。从 Swagger JSON 快速生成 TypeScript / JavaScript 接口代码，多文档配置一站管理，响应结构可自定义提取。
Skip to content
30 秒上手
按你的包管理器选一条安装，随后在项目目录执行：
sh
pnpm add -g @fxri/swagger2apish
npm install -g @fxri/swagger2apish
yarn global add @fxri/swagger2apish
# 交互式生成接口代码（npx/dlx 均需带作用域全名，裸写会拉取同名其他包）
npx @fxri/swagger2api详细步骤见新手指南。
解决什么痛点
| 痛点 | 本工具的做法 |
|---|---|
| 后端 Swagger 文档到手，接口代码要手写 | 一行命令从 Swagger JSON 生成 TS/JS 接口文件，含请求方法与类型定义 |
| 多个项目的接口配置散落，更新要挨个跑 | 自动扫描全部 saconfig*.json，多选或一键全量更新 |
| 重名接口被加 _n 后缀，调用方看着懵 | 地址 + 请求方法拼接唯一 operationId，从源头避免重名 |
| 每次生成都要重新确认一遍参数 | 快速模式直接复用配置文件参数，一行命令静默更新 |
文档索引
| 文档 | 适合谁 |
|---|---|
| 新手指南 | 第一次接触，想 30 秒跑起来 |
| 完整攻略 | 日常使用：三种模式、响应提取、配置文件 |
| CLI 参考 | 查命令、参数、默认值 |
| FAQ | 遇到问题先来这里找 |
环境要求
- Node.js >= 20