Elysia Tools
导航
Development
将 OpenAPI 或 Swagger 的 JSON/YAML 规范转换为 TypeScript 接口类型、请求参数类型和响应类型，并支持输出格式与命名风格配置
执行
填写表单、运行工具，并在同一页面查看结果。
案例
相关内容
等待运行
工具使用指南
OpenAPI 转 TypeScript 类型生成器是一款高效的开发工具，旨在帮助开发者将 OpenAPI 或 Swagger 规范（JSON/YAML）快速转换为类型安全的 TypeScript 接口、请求参数及响应模型，从而显著提升前后端联调效率并减少手动编写类型定义的工作量。
背景
项目后端提供了最新的 OpenAPI 3.0 规范文档，需要快速在前端项目中建立对应的 API 类型定义。
问题
手动编写 TypeScript 接口耗时且容易出错，无法保证与后端定义完全同步。
如何使用
将 YAML 格式的规范粘贴到输入框，选择“扁平导出”和“Interface”风格，开启包含描述注释。
sourceFormat: yaml, outputFormat: flat, namingStyle: pascal, declarationStyle: interface, includeDescriptions: true结果
生成了清晰的 User 接口及对应的 GetUserResponse 类型，包含所有字段定义及原始注释。
支持 OpenAPI 3.0 及以上版本，同时也兼容常见的 Swagger 2.0 规范。
支持 PascalCase、camelCase 以及保留原样三种命名风格，方便适配不同的项目编码规范。
可以，工具提供了声明风格选项，支持在 interface 和类型别名（type）之间进行切换。
是的，只要勾选“包含描述注释”选项，工具会自动将 OpenAPI 中的 description 字段转换为 TypeScript 的 JSDoc 注释。
工具支持“命名空间包裹”模式，可以将生成的类型组织在指定的命名空间内，有效避免全局命名冲突。