Go 测试最佳实践
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-testing。
技能介绍
测试在约束什么
不少 Go 项目把测试当成「凑覆盖率」或「PR 门禁」,结果出现表格用例没有名字、集成和单元混在一起跑、用例隐式依赖执行顺序,或者断言绑在父级 *testing.T 上导致子测试失败却显示 PASS。这类测试今天绿、明天脆,也很难从输出里定位到底是哪条 case 坏了。
技能如何引导你写和审测试
本技能把测试定位为可执行规约:约束对外可观察行为,而不是锁住实现细节。核心约定包括:表驱动必须用 t.Run 命名子测试;集成测试用 //go:build integration 与单元分离;用例互不依赖,可并行处用 t.Parallel();含 goroutine 的包在 TestMain 里用 goleak.VerifyTestMain 查泄漏;mock 接口而非具体类型;testify 作辅助而非替代标准库。
在 Write 模式下,按被测源码顺序推进,可用 gotests 搭表驱动骨架,再补边界与错误路径。Review 盯 PR 里测试 diff:新行为是否覆盖、断言质量、是否含不稳定模式。Audit 可并行分三块:单测质量与覆盖缺口、集成隔离与 build tag、goroutine/竞态。Debug 则按复现 → 隔离断言 → 追到生产代码或 setup 根因的顺序处理失败或 flaky。
文件组织上,默认一个源文件对应一个 foo_test.go(工具与评审都按源文件找测试);测试函数顺序宜与被测符号在源文件中的顺序一致,便于对照滚动阅读。文中还点出一个常见坑:不要在父测试里 assert.New(t) 再在 t.Run 里复用,否则会断言作用域泄漏。
适用边界
依赖 gotests(go install github.com/cweill/gotests/gotests@latest)。数据库集成、testify 细 API、goleak 细节、CI 与 lint(如 testifylint、paralleltest)在 SKILL.md 中指向同系列的其它 golang 技能;若组织内有覆盖同一主题的自定义公司技能,以其为准。
使用场景
- 新功能上线前要为现有包补表驱动单测,并确保每条 case 都有 `t.Run` 子测试名
- PR 里只改了测试文件,需要按 diff 检查新行为是否被断言覆盖、有无顺序依赖或 flaky 写法
- 老项目 `go test` 偶发失败,需要按 Debug 流程复现并区分是生产 bug 还是 setup/断言作用域问题
- 接手包含 goroutine 的模块,要在审计阶段查单测缺口、集成 build tag 隔离和 goleak 泄漏风险
适合人员
- 维护 samber 风格 Go 微服务的工程师,希望 PR 测试改动符合团队约定的并行与 build tag 规范
- 负责 Code Review 的 Tech Lead,要在合并前快速判断测试是否耦合实现细节或存在子测试断言泄漏
- CI 上集成测试与单元混跑导致耗时不稳定,需要按技能拆分 `integration` build tag 并理顺 TestMain/goleak
- 调试 flaky 用例的 SRE 或后端,需要把 Audit 三视角(单测、集成、竞态)收成一份缺口报告