Go测试入门只需掌握go test运行规则:测试文件以_test.go结尾、函数名以Test开头、参数为*testing.T;用表驱动测试组织用例,优先使用t.Error等原生方法。

Go测试入门不需要先学完所有语言特性,而是从 go test 能跑通的第一行断言开始——只要你会写函数,就能立刻写测试。
从 TestXxx 函数名和 *testing.T 开始写起
这是唯一强制要求:测试文件必须以 _test.go 结尾,函数名必须是 Test 开头,参数类型固定为 *testing.T。其他任何“规范”(比如是否用 require、是否 mock)都是后续演进,不是起步门槛。
- 别纠结“要不要测私有函数”——先测你刚写的那个
Add(a, b int) int就行 - 别等项目结构搭好再测——在
main.go同目录下直接建main_test.go就能跑 - 常见错误:
func TestAdd(t testing.T)(漏了指针符号*),会报missing argument for TestAdd: expected *testing.T
用表驱动测试(table-driven tests)代替一堆 if 判断
手动写多个 TestAdd1、TestAdd2 是反模式。Go 社区默认用切片组织用例,既清晰又易扩展,且失败时能精准定位哪一组输入出错。
func TestAdd(t *testing.T) {
tests := []struct {
a, b, expected int
}{
{1, 2, 3},
{0, 0, 0},
{-1, 1, 0},
}
for _, tt := range tests {
result := Add(tt.a, tt.b)
if result != tt.expected {
t.Errorf("Add(%d, %d) = %d, want %d", tt.a, tt.b, result, tt.expected)
}
}
}
- 别把测试逻辑塞进循环体里——每个
t.Errorf都自带行号和上下文,够用 - 别过早引入
subtest(t.Run)——只有当需要独立 setup/teardown 或想折叠日志时才加 - 注意:结构体字段名首字母必须大写(如
expected→Expected),否则在子测试中无法被go test -v显示
运行命令只记两个:go test 和 go test -v
go test 默认静默运行,只输出 PASS 或失败摘要;go test -v 才显示每个 TestXxx 的执行过程和 t.Log/t.Errorf 输出。没有“调试模式”,也不需要配置文件。
- 别用
go run xxx_test.go——会报undefined: testing.M,Go 测试必须走go test入口 - 别一上来就加
-race或-cover——它们对新手属于干扰项,等你能稳定写出 5 个以上通过测试再开启 - 如果提示
no buildable Go source files,检查是否把测试函数写在了非_test.go文件里,或包声明写成了package main_test(应为package main)
最容易被忽略的是:Go 测试不依赖任何第三方断言库,t.Error、t.Fatal、t.Log 这三个方法已覆盖 95% 场景。先用熟它们,比研究 testify 或 gomock 实际得多。










