文章目录OpenAPI Generator写一次接口定义生成 50 语言客户端代码这东西到底干嘛的支持哪些语言怎么用局限性谁在用OpenAPI Generator写一次接口定义生成 50 语言客户端代码openapi-generator 在 GitHub 上已经拿到 26.4K Star 了。这个项目解决一个很实际的问题你写了一份 OpenAPI 规范文件它能帮你自动生成 50 多种编程语言的客户端 SDK、服务器框架代码、API 文档和配置文件。这东西到底干嘛的简单说就是把 OpenAPI 规范以前叫 Swagger变成各语言的可用代码。做过 API 开发的人都知道维护多语言客户端有多痛苦。你有一个后端服务前端用 TypeScript 调移动端用 Swift 和 Kotlin 调数据团队用 Python 调。每次接口改个字段你要在四五个语言的 SDK 里同步修改改漏了就是线上 bug。OpenAPI Generator 的做法是把 OpenAPI 规范当成唯一的真实来源然后自动生成各个语言的客户端代码。你改了规范跑一次命令所有语言的代码都更新了。支持哪些语言覆盖面很全。主流语言基本都在Python、Java、Go、JavaScript/TypeScript、Rust、C#、Ruby、PHP、Swift、Kotlin、Dart、Elixir、Haskell。连 Ada、Nim、OCaml 这些相对小众的也支持。服务器端框架也没落下Spring Boot、Flask、Gin、ASP.NET Core、Ktor、Vert.x、FastAPI、Sinatra、Rails 都能生成。除了客户端和服务器代码还能生成 API 文档HTML、Markdown、Confluence Wiki、Postman Collection、Protocol Buffer 定义、GraphQL schema、MySQL 建表语句。一份规范API 生态里需要的东西基本都能产出。怎么用最直接的方式是命令行。下载 JAR 包一行命令搞定java-jaropenapi-generator-cli.jar generate\-ipetstore.yaml\-gpython\-o./sdk/python-i指定规范文件-g指定目标语言-o指定输出目录。跑完就能在输出目录拿到可以直接用的代码。除了 JAR 包还有 Homebrew、Docker、NPM、pip 几种安装方式。Java 项目可以直接用 Maven 插件或 Gradle 插件集成到构建流程里CI/CD 跑构建的时候自动生成最新的客户端代码。生成出来的代码不是空壳。它包含完整的模型定义、请求构造、响应解析、错误处理、认证逻辑部分语言还带单元测试框架。你可以直接在此基础上做业务开发不用从零写 HTTP 通信层。局限性生成的代码是基于模板的通用实现。复杂业务场景下你可能需要在生成代码的基础上做定制。比如特殊的序列化逻辑、自定义的重试策略、特定的缓存机制这些都需要自己加。另外规范文件的质量直接影响生成代码的质量。规范写得不好生成的代码也不好用。谁在用GitHub、Microsoft、Google、Cisco、Netflix、Uber、Shopify 都在用。项目有专门的技术委员会维护更新频率稳定当前版本 7.23.0兼容 OpenAPI 规范 2.0 和 3.0。如果你的团队在维护多语言 API 客户端或者在做前后端分离需要生成客户端代码又或者想从 API 规范直接生成服务端骨架代码这个工具值得花半天时间试一下。前后端分离需要生成客户端代码又或者想从 API 规范直接生成服务端骨架代码这个工具值得花半天时间试一下。