Go测试函数名必须以Test开头、参数为testing.T,且需置于_test.go文件中;t用于报错,子测试用t.Run;表驱动测试推荐结构体切片+name字段;BenchmarkXxx(b testing.B)专用于性能测试。

test函数名必须以Test开头且参数是*testing.T
Go 的测试发现机制只认 func TestXxx(t *testing.T) 这种签名,大小写敏感,testXxx 或 Testxxx(小写 x)都不行。名字里不能有下划线,Test_add 会被忽略。
- 必须放在
_test.go文件里,比如calc_test.go,和被测代码calc.go同目录 -
t是唯一可交互的测试上下文,报错用t.Error、t.Fatal,不能用log.Fatal或panic—— 后者会终止整个测试套件 - 子测试想用
t.Run,但父测试函数名仍得是TestXxx,不是TestXxx_YYY
表驱动测试怎么组织数据和断言
硬编码多组输入输出容易让测试函数膨胀,也难看出哪组 case 失败。用结构体切片 + range 是 Go 社区通用做法,关键在错误信息要带上下文。
- 每个测试项建议包含
name字段,传给t.Run(name, ...),失败时能一眼定位 - 断言别只写
if got != want { t.Errorf(...) },把got和want都打出来:t.Errorf("case %q: got %v, want %v", tc.name, got, want) - 如果被测函数返回 error,记得检查
if tc.wantErr != nil && err == nil或if tc.wantErr == nil && err != nil,光比 error message 容易漏空指针
func TestDivide(t *testing.T) {
tests := []struct {
name string
a, b int
want int
wantErr bool
}{
{"positive", 10, 2, 5, false},
{"zero divisor", 10, 0, 0, true},
}
for _, tc := range tests {
t.Run(tc.name, func(t *testing.T) {
got, err := Divide(tc.a, tc.b)
if tc.wantErr {
if err == nil {
t.Fatal("expected error but got nil")
}
return
}
if err != nil {
t.Fatalf("unexpected error: %v", err)
}
if got != tc.want {
t.Errorf("got %v, want %v", got, tc.want)
}
})
}
}
testing.T 和 testing.B 的核心区别在哪
*testing.T 用于功能验证,*testing.B 专为性能压测设计,二者生命周期、方法集、运行方式完全不同。
-
BenchmarkXxx(b *testing.B)函数里必须调用b.ResetTimer()(如需排除 setup 开销)和b.ReportAllocs()(看内存分配),否则结果不准 -
b.N是框架自动调整的循环次数,不是你手动写的 for 循环上限;必须写成for i := 0; i ,否则 <code>go test -bench不识别 - 不能在 benchmark 里调用
t.Log或b.Error,它们不接受日志或失败中断 —— benchmark 崩溃就直接 panic,不会标记失败 - 并发 benchmark 要用
b.RunParallel,但注意被测函数必须是线程安全的,否则结果不可靠
go test 常见失败原因和绕过陷阱
运行 go test 报错,90% 和环境或命令细节有关,不是代码问题。
立即学习“go语言免费学习笔记(深入)”;
-
no buildable Go source files:当前目录没.go文件,或只有_test.go但没对应非测试文件(比如删了main.go只留main_test.go) -
undefined: xxx:测试文件 import 路径写错,或被测函数没导出(首字母小写),Go 不允许跨包访问未导出标识符 -
timeout:默认 10 分钟,单个测试跑太久会中断;加-timeout 30s控制,或在测试里用t.Parallel()并发跑独立 case - 想跳过某些测试?用
go test -run ^TestFoo$精确匹配,别信网上说的// +build ignore—— 那是构建标签,对go test无效
测试文件里 import 的包,只要没在测试函数里实际用到,Go 会静默忽略,所以别靠 import 列表判断依赖是否完整。










