代码生成工具讲解：Swagger Codegen / OpenAPI Generator 与 openapi-typescript/vite-plugin-openapi-ts
Swagger Codegen / OpenAPI Generator 与 openapi-typescript/vite-plugin-openapi-ts 有什么关系和区别？这两组工具的目标相似（根据 OpenAPI 生成代码），但设计哲学、输出粒度、使用体验完全不同。
核心区别一览
| 维度 | Swagger Codegen / OpenAPI Generator | openapi-typescript / vite-plugin-openapi-ts |
|---|---|---|
| 定位 | 通用多语言代码生成器 | TypeScript 专用的类型/客户端生成器 |
| 支持语言 | Java, TypeScript, Go, Python, C#… 40+ 种 | 仅 TypeScript |
| 生成内容 | 完整的 API 客户端 SDK（含请求函数、模型、配置） | 主要生成 TypeScript 类型定义（interface），可选生成轻量客户端 |
| 体积/复杂度 | 生成的代码量较大，功能全面（支持 OAuth、重试、多服务器等） | 生成的代码极简，只包含类型和少量请求封装 |
| 集成方式 | 命令行工具（或 Maven/Gradle 插件），需手动运行 | 可集成到 Vite 构建流程（自动生成）或手动运行 CLI |
| TypeScript 支持 | 生成.ts文件，但类型表达可能不够精确（历史原因） | 原生 TypeScript，生成的类型完美匹配 OpenAPI schema |
| Tree Shaking | 生成的 SDK 通常整体引入，难以摇树 | 类型仅编译时存在，运行时零开销；客户端可按需导入 |
| 维护活跃度 | OpenAPI Generator 活跃，Swagger Codegen 较稳定 | openapi-typescript 活跃，vite-plugin 较新 |
详细对比
1. 目标用户不同
OpenAPI Generator：面向需要多语言客户端的团队，比如后端 Java、前端 TypeScript、移动端 Swift 都想用同一份 OpenAPI 生成 SDK。
openapi-typescript：面向纯 TypeScript 前端项目，且希望类型精确、生成速度快、代码体积小。
2. 生成的代码风格差异
OpenAPI Generator (TypeScript-Axios)会生成：
ts
// 完整类 + 配置对象 export class CapitalAdjustmentsApi { constructor(basePath?: string, configuration?: Configuration) public async queryCapitalAdjustPage(requestParameters: QueryRequest, options?: AxiosRequestConfig): Promise<AxiosResponse<PageResult>> { // 几十行实现代码 } }openapi-typescript只生成：
ts
export interface paths { "/capital/adjustments/query": { post: { requestBody: { content: { "application/json": CapitalAdjustQueryRequest } }; responses: { 200: { content: { "application/json": PageResult<CapitalAdjustResponse> } } }; }; }; }你还需要配合openapi-fetch或手写请求函数，但类型完全由paths推导。
3. 使用体验
OpenAPI Generator：适合“拿到 OpenAPI 后一键生成整个 SDK”，然后直接调用
api.query(...)，无需关心请求细节。但生成的代码较大，且需要处理生成器版本与 TypeScript 版本的兼容性。openapi-typescript：适合“只想要类型安全，请求库我自己写或已有封装”。生成的类型非常精确，不会产生运行时冗余代码。搭配
vite-plugin后可在开发时自动更新类型，体验流畅。
4. 生态关系
OpenAPI Generator最初是 Swagger Codegen 的分支，更活跃，支持 TypeScript 多种模板（
typescript-axios、typescript-fetch、typescript-node等）。openapi-typescript是专注 TypeScript 类型的后起之秀，强调“只做一件事并做好”。
vite-plugin-openapi-ts是其生态的 Vite 集成。
何时选择哪个？
选 OpenAPI Generator：你需要生成多种语言的客户端，或者你希望得到一个“开箱即用”的完整 SDK（包括请求函数、错误处理、重试等），不介意生成的代码体积。
选 openapi-typescript：你只有 TypeScript 前端项目，希望类型完美、零运行时开销、与 Vite 构建无缝集成，并且你已经有自己习惯的请求库（如 axios、fetch）。
可以混用吗？
理论上可以——用 OpenAPI Generator 生成 Java 后端客户端，用 openapi-typescript 生成前端类型。但不要在同一前端项目中混用两者生成 TypeScript 代码，否则会有两套类型定义和客户端实现，造成混乱。
总结
OpenAPI Generator 是“瑞士军刀”，功能全、语言多、代码重；openapi-typescript 是“手术刀”，专攻 TypeScript、精确、轻量。
对于你的 Vue 3 + Vite 项目，如果只需要类型安全和简单的请求封装，vite-plugin-openapi-ts更合适；如果未来需要生成其他语言的 SDK，则考虑 OpenAPI Generator。