Go单元测试需严格遵循约定:函数名以Test开头且首字母大写,参数为*testing.T,无返回值,文件名以_test.go结尾;用t.Errorf/t.Fatal报告失败,私有函数同包直接调用,推荐表驱动测试配合t.Run子测试。

Go 语言的单元测试不需要第三方框架,testing 包开箱即用,但写法和习惯与其他语言差异较大——测试函数必须以 Test 开头、接收 *testing.T 参数、不能返回值,否则 go test 根本不会识别。
测试函数命名和签名必须严格符合约定
Go 不靠注解或配置发现测试,只靠函数名前缀和签名匹配。任意偏差都会导致测试被跳过,且无提示。
- 函数名必须以
Test开头,后接**大写字母开头**的有意义名称(如TestAdd,不能是testAdd或Test_add) - 参数有且仅有一个,类型为
*testing.T - 返回值必须为空(不能写
error或bool) - 文件名必须以
_test.go结尾(如calc_test.go),且与被测代码在同一个包内
用 t.Errorf 和 t.Fatal 报告失败,别用 panic 或 log
测试中出错不能靠 panic 或 log.Fatal 终止,否则 go test 无法捕获上下文、不计入失败统计,还会中断整个测试流程。
-
t.Errorf("msg"):记录错误,当前测试继续执行(适合检查多个断言) -
t.Fatal("msg"):记录错误并立即终止当前测试函数(适合前置条件不满足,如 setup 失败) - 不要用
fmt.Println或log.Print输出“成功”信息——go test默认只显示失败输出,加-v才看t.Log
测试私有函数要放在同一包下,不是“反射调用”
Go 没有“测试专用访问权限”。想测 func calculate(...)(小写开头),就把它和测试函数一起放在 calc.go 和 calc_test.go 中,同属 calc 包。测试文件里直接调用即可。
立即学习“go语言免费学习笔记(深入)”;
常见误解是把测试放到 calc_test 独立包里再 import 原包——那样只能访问导出(大写开头)的标识符,私有函数根本不可见。
func TestCalculate(t *testing.T) {
result := calculate(2, 3) // 直接调用私有函数,因为同包
if result != 5 {
t.Errorf("expected 5, got %d", result)
}
}
表驱动测试比多个 Test 函数更清晰、易维护
对同一函数做多组输入/输出验证时,硬写多个 TestXxx1、TestXxx2 会导致重复代码、难以扩展。推荐用结构体切片 + range 循环。
- 每个测试用例包含
name(用于t.Run子测试)、input、expected - 用
t.Run(name, func(t *testing.T) {...})隔离子测试,失败时能精准定位是哪一组数据出问题 - 避免在循环里直接用
i或闭包变量,要显式传参或赋值给局部变量
func TestAdd(t *testing.T) {
tests := []struct {
name string
a, b int
expected int
}{
{"positive", 1, 2, 3},
{"zero", 0, 0, 0},
{"negative", -1, -1, -2},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
if got := Add(tt.a, tt.b); got != tt.expected {
t.Errorf("Add(%d,%d) = %d, want %d", tt.a, tt.b, got, tt.expected)
}
})
}
}
最容易被忽略的是子测试(t.Run)的使用场景:当测试逻辑含初始化、资源清理或并发验证时,它能避免变量污染和 panic 传播;而很多人写完第一个 t.Errorf 就停了,没意识到后续校验可能同样重要。










