openapi-generator 是生成 Go 客户端代码的首选工具，需用 openapi-generator generate -i openapi.yaml -g go -o ./client 命令，配合 --additional-properties 设置 packageName、withGoCodegenV2=true 等参数，并手动处理超时、鉴权、错误分类及路径编码问题。
OpenAPI 文档生成 Go 客户端代码，openapi-generator 是目前最稳定、兼容性最好、社区维护活跃的选择；swagger-codegen 已归档，不建议新项目使用。
用 openapi-generator-cli 生成 Go 客户端
核心命令是 openapi-generator generate，关键在指定语言、输入文档路径和输出目录。生成前需确认 OpenAPI v3 文档（openapi.yaml 或 openapi.json）格式合法，否则会报错如 Unable to read/open input document 或 missing required field 'openapi'。
推荐做法：
- 安装 CLI：用
npm install -g @openapitools/openapi-generator-cli（需 Node.js），或下载二进制（见 GitHub Releases） - 基础生成命令：
openapi-generator generate -i openapi.yaml -g go -o ./client - 加
--skip-validate-spec可跳过规范校验（仅调试时用，生产环境务必校验） - 加
--additional-properties=packageName=myclient,withGoCodegenV2=true启用新版 Go 生成器（v5.4+ 默认启用，但显式声明更稳妥）
go generator 的关键参数与行为差异
不同 --additional-properties 值直接影响生成代码的结构和可用性。默认生成器（go）产出的是带 Configuration 和 APIClient 的标准封装，但不自动处理鉴权、重试或上下文超时——这些得自己补。
立即学习“go语言免费学习笔记（深入）”；
Golang Google Wire
下载
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
常用配置项：
-
packageName：生成包名，默认openapi，建议设为有意义的名称（如paymentsdk） -
withGoCodegenV2=true：启用新生成器，支持泛型、更准的 struct tag（如json:"id,omitempty"）、正确处理nullable: true -
generateModels=true/generateApis=true：可分别开关 model 和 client 生成（调试时有用） -
enumClassPrefix=true：避免枚举名与 struct 冲突（如StatusvsStatusEnum）
注意：go-server 是服务端模板，别误用；客户端只用 go。
生成后必须手动处理的几件事
生成代码不是开箱即用。常见问题包括：
- HTTP 客户端未设置超时：
http.DefaultClient被硬编码，应替换为自定义http.Client并设Timeout和Transport - 鉴权逻辑缺失：即使 OpenAPI 定义了
securitySchemes，生成器也只加注释，不写实际 header 注入逻辑（需在调用APIClient前手动设置config.DefaultHeader["Authorization"]） - 错误处理扁平：所有接口返回
*http.Response+error，但没做 HTTP 状态码分类（如 401/403/500 需单独判断） - 路径参数编码不全：若路径含斜杠或特殊字符（如
/v1/files/{path}），生成代码默认不做url.PathEscape，需自行 wrap 或 patchprepareRequest
最易被忽略的是：生成器不会读取 x-go-package 或 x-go-name 扩展字段（除非用自定义模板），所以模型命名冲突、字段别名失效这类问题，只能靠 post-process 脚本或改 OpenAPI 源头来解决。
