gomock是最主流Go mock工具，通过mockgen自动生成mock结构体；推荐source模式指定源文件生成，需注意路径、包名及internal包处理；使用时必须调用ctrl.Finish()并声明EXPECT()，HTTP接口级mock应优先选用httptest.Server。
用 gomock 生成 mock 接口最直接
Go 官方不内置 mock 工具，gomock 是最主流、与 go test 集成最顺的方案。它通过 mockgen 命令从接口定义自动生成 mock 结构体，避免手写错误和维护负担。
安装只需两步：
- 运行
go install github.com/golang/mock/mockgen@latest
- 确认
$GOPATH/bin（或 Go 1.21+ 的$HOME/go/bin）已加入$PATH，能直接调用mockgen
注意：不要用 go get 安装旧版，v1.6.0+ 才支持 Go Module 和嵌套包路径；若提示 command not found，大概率是路径没配对。
mockgen 命令参数选错会导致 mock 文件为空
mockgen 有两种模式：source（从 .go 文件解析接口）和 reflect（从已编译包反射提取）。日常开发推荐 source 模式，更可控、无需提前构建。
立即学习“go语言免费学习笔记（深入）”；
典型正确用法：
mockgen -source=service.go -destination=mocks/mock_service.go -package=mocks
关键点：
-
-source必须指向**含interface定义的 Go 源文件**，不能是*.go通配符或目录 -
-destination路径需存在，父目录要手动创建；文件名随意，但建议带mock_前缀 -
-package必须与目标文件所在目录名一致，否则导入时报no required module provides package - 如果接口在
internal/下，mockgen默认跳过——加-self_package显式指定包路径
在测试中使用 mock 时，忘记 EXPECT() 会 panic
gomock 是“预期驱动”：每个方法调用都必须提前声明期望行为，否则运行时触发 panic: Unexpected call。
常见写法：
ctrl := gomock.NewController(t)
defer ctrl.Finish() // 必须，否则未验证的 EXPECT 会被忽略
mockSvc := mocks.NewMockYourService(ctrl)
mockSvc.EXPECT().GetUser(gomock.Any()).Return(&User{Name: "test"}, nil).Times(1)
容易漏掉的细节：
-
ctrl.Finish()缺失 → 测试通过但实际没校验调用是否发生 -
.Times(1)不写 → 默认只允许调用 1 次，多调一次就失败；想允许多次用.Times(0, 1)或.AnyTimes() - 参数匹配用
gomock.Eq(val)精确匹配，gomock.Any()放行任意值，别直接传字面量（会报类型不匹配）
HTTP 接口级 mock 更适合用 httptest.Server 而非 gomock
如果你的目标是“模拟一个外部 HTTP 接口返回 JSON”，不要费劲用 gomock 去 mock http.Client——它太底层，且容易绕过 TLS/重试/超时逻辑。
直接起一个临时服务更可靠：
server := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(map[string]string{"id": "123"})
}))
defer server.Close()
// 把 client.BaseURL 指向 server.URL
client := &APIClient{BaseURL: server.URL}
这种写法优势明显：
- 完全走真实 HTTP 栈，覆盖 header、status code、body 解析等全链路
- 无需引入额外依赖，
net/http/httptest是标准库 - 比 mock
RoundTripper更少出错，尤其涉及重定向或 cookie 时
真正需要 gomock 的场景，是隔离你自己的业务接口依赖（比如 UserService、PaymentGateway），而不是模拟第三方 HTTP 服务。
