Swagger Codegen 不推荐用于 Go 客户端生成，因其已归档、依赖过时 go-swagger、不支持 modules/context、HTTP client 不可定制、模型指针滥用且不兼容 OpenAPI 3.1。
Go 里不推荐用 Swagger Codegen 生成客户端 —— 它已归档，对 Go 的支持停留在 v2.4.x，生成的代码依赖过时的 go-swagger 运行时、不兼容 Go modules、无 context 支持、HTTP client 硬编码且不可定制。
为什么 Swagger Codegen 生成的 Go 客户端现在基本不能用
Swagger Codegen 项目在 2021 年已正式归档（swagger-api/swagger-codegen），官方明确转向 openapi-generator。但更关键的是：它为 Go 生成的客户端严重脱节于现代 Go 实践：
- 生成的代码默认依赖
github.com/go-swagger/go-swagger的旧版运行时，与当前主流go-swaggerCLI（v0.30+）不兼容 - 所有 HTTP 调用绕过
context.Context，无法做超时、取消或传递 trace ID -
HTTPClient字段是私有且不可替换的，无法注入自定义 transport、retry 逻辑或 mock client - 生成的模型结构体大量使用指针字段（如
*string），导致 JSON 序列化行为反直觉，且无零值友好处理 - 不支持 OpenAPI 3.1，对
oneOf/anyOf等新特性生成错误或直接 panic
替代方案：用 openapi-generator + go-server 模板生成可维护客户端
openapi-generator 是 Swagger Codegen 的活跃继任者，对 Go 支持更完善，且提供多个目标模板。生成生产级客户端应选 go（非 go-server）模板，并严格配置参数：
- 用
generatorName=go（不是go-server）—— 后者生成服务端框架，前者才生成客户端 SDK - 必须加
--additional-properties=withGoCodegenV2=true启用新版 Go 生成器（v2），否则仍走老路径 - 显式指定
--additional-properties=packageName=apiclient,projectName=myapp避免默认包名冲突 - 添加
--additional-properties=generateInterfaces=true可导出接口，便于 mock 和测试 - 通过
--type-mappings修复常见类型映射问题，例如：DateTime=github.com/segmentio/timeutil.Time
命令示例：
openapi-generator generate \ -i openapi.yaml \ -g go \ --additional-properties=withGoCodegenV2=true,packageName=apiclient,generateInterfaces=true \ --type-mappings=DateTime=time.Time \ -o ./client
手动封装生成代码：补足 context、重试和错误处理
即使用了 openapi-generator，生成的客户端仍缺关键能力。必须在外层包装一层薄适配器：
- 所有方法签名追加
ctx context.Context参数，并传给内部http.Client.Do() - 用
github.com/hashicorp/go-retryablehttp替换默认 client：创建retryablehttp.Client，再取其.StandardClient()赋给生成 client 的cfg.HTTPClient - 错误统一转为实现了
error接口的结构体，包含StatusCode、RawBody和原始error，避免只抛fmt.Errorf("api error") - 禁止直接调用生成 client 的
ServiceOperationCreate(...)方法；全部走你封装的Create(ctx, req, opts...)，其中opts可含WithTimeout(30*time.Second)等
示例封装片段：
func (c *Client) CreateUser(ctx context.Context, user User) (*User, error) {
// 转换 ctx 到 http.Request
req, err := c.client.UserApi.CreateUser(context.WithValue(ctx, "x-request-id", uuid.New()))
if err != nil {
return nil, err
}
// 注入自定义 header、trace propagation 等
req.Header.Set("X-Trace-ID", trace.FromContext(ctx).ID())
resp, err := c.httpClient.Do(req)
// ... 处理 resp.StatusCode, unmarshal, 错误分类
}
真正省心的做法：跳过代码生成，用 go-swagger client runtime 手写核心调用
对于中等复杂度 API（go-swagger 提供的 runtime.ClientTransport + strfmt 类型即可快速构建类型安全、可测、可调试的客户端：
- 定义请求结构体，用
strfmt.DateTime、strfmt.UUID等替代裸string，自动校验格式 - 用
runtime.ClientRequest构建请求，设置 path/query/header，调用transport.Submit() - 错误处理直接 switch
resp.Payload类型（如*models.ErrorResponse），而非字符串匹配 - 整个过程无代码生成依赖，IDE 补全正常，单元测试可轻松注入 fake transport
这要求你读一遍 OpenAPI spec，但换来的是可控性、调试可见性和长期维护性 —— 很多团队发现，半年后回看生成的 2w 行客户端代码，还不如当初花半天手写 300 行。
真正麻烦的从来不是“怎么生成”，而是生成后谁来修 bug、加 context、改重试策略、适配新 auth 方式。这些工作不会因为用了 codegen 就消失，只会被埋得更深。
