go测试文件必须命名为xxx_test.go且与被测组件同目录同包；测试函数须为func testxxx(t *testing.t)，首字母大写，否则go test将忽略。
测试文件必须叫 xxx_test.go 且和组件同包
Go 的测试发现机制只扫描 _test.go 后缀的文件，且要求和被测组件（比如 cache.go、router.go）在**同一目录、同一包名下**。如果把测试放到 internal/testutil 或单独建 test 包，就访问不到未导出字段或函数，go test 也压根不会执行它。
常见错误现象：cache_test.go 放错目录导致 TestCacheSet 不被识别；或者测试文件里写 package test，而组件是 package cache，结果编译报错或无法调用私有方法。
- 被测组件是
func NewRedisClient() *redis.Client，测试文件就叫redis_client_test.go - 测试函数必须是
func TestNewRedisClient(t *testing.T)，不能是testNewRedisClient或Testnewredisclient - 别为了“整洁”把所有测试塞进一个大文件——按组件拆分，比如
cache_test.go、cache_middleware_test.go
表驱动测试组织多场景输入输出
组件往往要处理各种配置组合、边界值、错误路径，硬编码多个 if 断言会让测试函数膨胀且失败时难定位。用结构体切片 + t.Run 是最直接有效的做法。
关键点在于每个 case 必须带 name 字段，并在循环内显式重声明变量（tt := tt），否则闭包会捕获最后一个值。
- 输入字段建议覆盖：正常值、空值、超长字符串、负数、nil 指针
- 断言时别只比结果，要把
got和want都打出来：t.Errorf("case %q: got %v, want %v", tc.name, got, want) - 如果组件返回
error，检查逻辑要完整：if tc.wantErr && err == nil和if !tc.wantErr && err != nil都得覆盖
依赖外部服务时必须抽象接口并注入 fake 实现
组件一旦调用 http.Get、time.Now()、os.Getenv 或 DB 方法，就不再是纯单元测试——它会变慢、不稳定、难以复现。Go 没有运行时 patch 机制，强行改全局变量（比如重赋值 time.Now）会导致并发测试相互污染。
正确做法是把依赖抽成接口，组件接收该接口作为参数（或通过 struct 字段注入），测试时传入可控的 fake 实现。
- 例如组件依赖时间，定义
type Clock interface { Now() time.Time }，而不是直接调用time.Now() - HTTP 客户端不要硬绑
http.DefaultClient，而是接收doer interface{ Do(*http.Request) (*http.Response, error) } - DB 操作封装为
type UserRepo interface { GetByID(id int) (*User, error) }，测试用内存 map 实现
并发组件必须用 t.Parallel() + t.Cleanup 隔离状态
像连接池、缓存、事件总线这类组件天然支持并发访问，但测试时若不加控制，多个子测试可能共享同一实例，造成竞态或状态残留。直接在测试里起 goroutine 而不等结束，还会导致 panic 或漏测。
t.Parallel() 让子测试真正并发执行（需手动加），t.Cleanup() 确保无论成功失败都会执行清理逻辑，比如关闭 mock server、重置全局计数器。
- 子测试内调
t.Parallel()前，确保 setup 过程无副作用（比如不修改全局变量） - 清理动作必须幂等：重复执行不应报错，比如
defer db.Close()改成t.Cleanup(func(){ db.Close() }) - 避免在 benchmark 函数里用
t.Parallel()或t.Cleanup()——*testing.B不支持这些方法
最常被忽略的是循环中忘记 tt := tt，以及把外部依赖当成“只是临时调一下”而不抽象——这两点会让测试在 CI 上间歇性失败，查起来极耗时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
