go测试要求test函数名与文件名严格匹配:函数须为func testxxx(t *testing.t),文件须为xxx_test.go,且同包、无返回值、参数唯一;必须用t.run表驱动,显式复制循环变量,合理使用t.error/t.fatal,并注意子测试并发安全。

Test函数名和文件名必须严格匹配go test的扫描规则
go test 不是靠“识别关键字”来运行测试,而是用硬编码规则扫描:只加载 _test.go 文件里、形如 func TestXxx(t *testing.T) 的函数。名字错一个字母、大小写不对、带下划线,就直接被忽略——连编译错误都不会报,静默跳过。
-
TestAdd✅ 合法;testAdd、Test_add、AddTest❌ 全部无效 - 文件名必须是
xxx_test.go,不能是test_xxx.go或xxx_test.golang - 测试函数必须和被测代码在同一个包(
package main或package utils),否则无法访问未导出函数/变量 - 函数不能有返回值,也不能多加参数,哪怕只是想传个
string也会导致编译失败
表驱动测试不是可选项,而是避免重复和定位失败的刚需
手写一堆 TestDivideByZero、TestDividePositive 看似清晰,实则难维护、难扩展、失败时看不出是哪组数据崩了。Go 社区默认用结构体切片 + t.Run,核心就两点:让每条用例有名字、让断言上下文完整。
- 每个测试项必须含
name字段,并传给t.Run(tc.name, ...),否则输出里全是空子测试名,比如--- FAIL: TestDivide/ - 断言别只写
if got != want { t.Errorf("fail") },要打全:t.Errorf("case %q: got %v, want %v", tc.name, got, want) - 检查 error 时不能只比字符串:
err != nil和tc.wantErr的布尔逻辑必须显式对齐,否则空指针或误判 - 循环变量要显式复制:
tc := tc,不然所有子测试闭包都引用最后一个tc
t.Error 和 t.Fatal 的行为差异直接影响调试效率
它们看起来都是“报错”,但执行路径完全不同:一个继续跑完当前测试函数,一个立刻终止。选错会导致漏掉关键失败,或让后续断言在无效状态下执行。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
t.Error记录错误后继续执行,适合同一函数里多个独立断言(比如验证返回值 + 验证 error + 验证日志) -
t.Fatal打印后立即 return,适合 setup 失败(如 mock server 启动失败)、前置条件不满足(如文件不存在)——但别在循环里乱用,会跳过所有剩余 case - 绝对不要在测试里调用
log.Fatal或panic,它们会终止整个go test进程,其他测试全被跳过
子测试(t.Run)不只是为了好看,它解决并发、重跑和隔离三大实际问题
不用 t.Run,所有用例挤在一个函数里,失败时只能看到 TestParseURL 整体挂了;用了之后,不仅能精准定位到 TestParseURL/valid,还能单独重跑这个子测试、控制并发、共享 setup 逻辑。
- 支持正则匹配重跑:
go test -run=TestParseURL/valid,开发时省去注释/反注释 - 子测试默认并发执行,可用
t.Parallel()显式声明(注意:需在t.Run内部第一行调用) - setup 成本高时(如初始化 DB 连接),可在
t.Run外做一次,内部子测试复用;但要注意并发安全——别用全局 map 或未加锁缓存 - 子测试之间完全隔离:一个 panic 不影响另一个,计时独立,失败标记独立
最容易被忽略的是并发干扰和变量捕获——这两个问题不会立刻报错,而是在 CI 上偶发失败,查半天发现是忘了写 tc := tc 或共享了一个没重置的 sync.Map。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










