精准匹配多版本API测试需函数名显式带版本前缀如TestV1Handler，用go test -run ^TestV1确保仅运行v1测试；各版本handler应独立封装、避免全局依赖；测试文件须与被测代码同目录同包名，禁止跨版本import；共用工具抽至internal/testutil；校验逻辑应抽象复用并表驱动验证一致性。
go test -run 怎么精准匹配多版本 API 测试函数
多版本 API（如 v1.Handler、v2.Handler）的测试函数命名必须可区分，否则 go test -run 会误匹配或漏跑。常见错误是统一用 TestHandler，结果 go test -run v1 什么也不执行——因为函数名不含 v1。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 测试函数名显式带版本前缀：
TestV1Handler、TestV2Handler，避免驼峰断开（TestV1GetUser✅，TestV1getuser❌） - 用
go test -run ^TestV1（注意^表示行首）确保只跑 v1 相关测试，防止子测试名冲突（如TestV1Handler_JSON也被包含） - 若共用表驱动结构，子测试名也需带版本标识：
t.Run("v1/json", func(t *testing.T) { ... })，否则-run v1无法命中
如何隔离 v1 和 v2 的 handler 依赖（比如中间件、路由注册）
不同版本 API 往往复用部分逻辑但依赖不同中间件或配置（如 v1 用 JWT，v2 改用 OAuth2），若测试时直接调用 http.ServeMux 或全局路由，v1 测试可能被 v2 的中间件污染。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 每个版本 handler 单独封装为函数，不依赖全局 mux：
func NewV1Router() *http.ServeMux，测试时只导入该函数 - 用
httptest.NewRecorder+ 手动构造http.Request，绕过路由层，直测 handler 函数签名：v1.Handler(w, r) - 避免在测试文件里 import v2 包——即使没调用，Go 仍会初始化其
init()函数，可能改写全局状态（如日志级别、DB 连接池）
测试文件放哪？package 声明写什么才不互相干扰
多版本 API 通常按目录分隔（api/v1/、api/v2/），但测试文件若都用 package v1 或 package main，容易因包名重复导致符号冲突或 go test 扫描错乱。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 测试文件与被测代码同目录、同包名：
api/v1/handler.go→api/v1/handler_test.go，包声明为package v1 - 禁止跨版本 import：v1 测试文件里不要
import "./v2"，否则go test ./api/v1会把 v2 也编译进来，增加失败风险 - 想共用测试工具函数（如
mustJSON）？抽到独立包internal/testutil，各版本测试文件再 import 它，而非彼此引用
怎么验证 v1 和 v2 对同一业务逻辑返回格式是否一致
版本升级常要求“行为兼容”，比如 GET /users 在 v1 返回 {"data": [...]}，v2 改为 {"items": [...]}，但字段结构和校验逻辑应一致。手动比对易漏。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 抽象出核心校验函数，如
validateUserResponse(body []byte) error，放在internal/domain下，v1/v2 测试都调用它 - 用表驱动测试覆盖相同输入：同一组用户数据，分别喂给 v1 和 v2 handler，断言各自 JSON 结构合规、字段值一致（忽略顶层 key 差异）
- 别用
reflect.DeepEqual直接比响应体——v1/v2 字段顺序、空值处理可能不同；改用json.Unmarshal到通用 map，再逐 key 校验关键字段
