简介
QuickType 解决的是「拿到一份接口返回的 JSON,却要自己一项项推敲字段类型」这件重复劳动:把样例数据丢进去,它直接给出目标语言的模型、序列化与校验代码。它服务的是要在多种语言之间对齐同一份接口契约的人——移动端写 Swift 或 Kotlin、服务端用 Python 或 Go、前端还要 TypeScript,几个端都在跟着同一个接口改。
项目本身是开源的,GitHub 侧积累了 13.9k 收藏,超过 200 位贡献者参与,转换目标覆盖 25 种以上的语言,既有 TypeScript、Python、Go、Rust、Swift、Kotlin 这些主力语言,也有 Zod、Effect Schema、JSON Schema、Smithy 这类 schema 与校验方向的目标。它的价值不在猜字段,而在把推断做细:空值、整数与浮点、日期与 UUID、枚举、联合类型、映射都会被识别,嵌套对象按属性名生成命名类型,pull_requests 会单数化成 PullRequest,同名不同结构则按上下文区分成 UserAddress 与 CompanyAddress。落地路径也不止一条,除了浏览器里的工作台,还有 npm 包、命令行与托管好的 MCP 服务,能把「接口一改、类型跟着改」接进构建流程。
适用人群
要在多个语言里同步同一份接口契约的人最适合用:后端定好 JSON,前端的 TypeScript、客户端的 Swift 或 Kotlin 模型一次生成,接口改字段时重跑一遍,编译器会把受影响的调用点指出来。用 AI 编码 agent 的人同样受益——把 MCP 服务接进 Claude Code、Cursor 或 Codex,体积大的接口响应不必塞进上下文,先拿字段结构再动手改代码。反过来,接口只有几个字段、或者后端已经直接吐出 SDK 的项目,不必为它多引入一层生成步骤;只想格式化、校验一段 JSON 的话,用更轻的在线小工具就够了。
优缺点
- ✅ 免注册、免费、开源,浏览器打开就能转换,生成结果直接复制走。
- ✅ 目标语言覆盖广,前端、后端与移动端常用语言都能出模型。
- ✅ 生成选项细,类还是结构体、属性是否可选、序列化方式都能在界面上调。
- ✅ 除浏览器外还有命令行与托管 MCP 两条路,能把类型生成接进流水线或交给 AI agent。
- ❌ 类型完全由样例推断,样例里没出现的字段、边界值与历史接口差异推不出来。
- ❌ 生成出来的模型是模板风格代码,文件本身不建议手改,要调整得回到数据侧重新生成。
使用方法
- 免注册免登录,打开浏览器里的工作台就能用:左侧贴进或从样例里选一份 JSON,右侧立刻出现生成结果,复制按钮把代码拿走,全程不涉及账号与付费。
- 先把目标语言定下来(默认给的是 Swift),再在 Options 里调生成风格,例如 Structs or classes 选 Struct、勾上 Make all properties optional,确认后点 Copy Code 取回模型文件。
- 要批量或接进流水线就装命令行:npm install -g quicktype,之后一条命令就能从文件出代码,也能指向线上接口,或者把 curl 的输出管给 quicktype 并指定目标语言与输出文件,接口变了重跑即可。
- 把它交给 AI 编码 agent:站内提供托管好的 MCP 服务,一个 HTTP 端点、不需要 API key,在 Claude Code 里用 mcp add 命令加进去,Cursor、Codex 等客户端填同一个地址也能接上,agent 就多了一种先看结构再改代码的能力。
- 注意两点:类型从样例推出来,样例要覆盖可选字段、空值与不同数值等多种形态,多喂几份样本比喂一份大文件更准(命令行可以直接指向一个样本目录);生成出来的模型文件不建议手改,需要调整就回到数据侧改样例重新生成。
收费说明
完全免费,也不需要注册。浏览器里的工作台打开就能转换,npm 包与托管 MCP 端点同样不收费:站内没有价目表、订阅入口或付费墙,也没有额度、次数与账号限制,全部功能都在免费范围内。项目靠开源社区维护,源码在 GitHub 上公开,成本主要落在自己运行命令行时占用的机器时间上。
平台支持
归类为网站与在线应用:浏览器里有一条完整的工作台,命令行通过 npm 安装后可在 Windows、macOS 与 Linux 上运行,另有托管 MCP 端点接入 Claude Code、Cursor、Codex 等客户端;没有独立桌面端、离线包与手机 App,也不需要 Google、Apple 之类的第三方账号登录。国内可以直接打开,不必自备代理;移动端浏览器能访问工作台,只是小屏上粘贴与核对代码不方便,长期使用还是命令行顺手。
截图













