go单元测试应优先使用标准testing包,测试函数须以test开头、接收*testing.t参数并置于同包的_test.go文件中;推荐用t.run组织子测试、t.parallel加速并发、避免t.fatal滥用,并通过接口抽象解耦依赖。

Go 自带的 testing 包足够写好单元测试,不需要额外框架——加了第三方库反而容易模糊测试边界、增加维护成本。
用 go test 运行测试函数必须满足命名和位置约束
Go 要求测试函数名以 Test 开头、接收单个 *testing.T 参数,且必须放在 _test.go 文件中(与被测代码同包)。文件名不匹配或函数签名错误会导致 go test 完全忽略该函数。
- 正确示例:
func TestAdd(t *testing.T)放在math_test.go - 错误写法:
func testAdd(t *testing.T)(小写开头)、func TestAdd(t *testing.T, extra string)(参数超限)、utils_test.go但函数在main包里(跨包不可见) -
go test默认只运行当前目录下与主包同名的测试;跨目录需显式指定路径,如go test ./service/...
testing.T 的常见误用:并发测试没加 t.Parallel() 或乱用 t.Fatal
多个测试函数默认串行执行;若想提速且逻辑无共享状态,应在函数体第一行调用 t.Parallel()。但注意:一旦用了它,就不能再调用 t.Log 或 t.Error 以外的任何 t. 方法(比如 t.Skip 会 panic)。
-
t.Fatal和t.Fatalf会立即终止当前测试函数,适合校验前置条件(如配置加载失败) -
t.Error只记录错误但继续执行,适合一次检查多个断言 - 不要在循环里用
t.Fatal—— 后续 case 不会跑;改用t.Errorf+ 显式break或重构为子测试
用 t.Run 组织子测试提升可读性与失败定位精度
当一个函数有多个输入组合要覆盖时,硬写一堆 TestXXX1/TestXXX2 很难维护。用 t.Run 定义子测试,既能共用 setup/teardown,又能独立失败、单独重跑。
立即学习“go语言免费学习笔记(深入)”;
func TestParseURL(t *testing.T) {
tests := []struct {
name, input string
wantErr bool
}{
{"empty", "", true},
{"valid", "https://example.com", false},
}
for _, tt := range tests {
tt := tt // 防止闭包引用复用
t.Run(tt.name, func(t *testing.T) {
_, err := url.Parse(tt.input)
if (err != nil) != tt.wantErr {
t.Errorf("Parse() error = %v, wantErr %v", err, tt.wantErr)
}
})
}
}
注意闭包变量捕获问题:循环内直接用 tt 会导致所有子测试看到最后一个值,必须显式声明 tt := tt。
真正难的是模拟依赖——比如 HTTP client、数据库连接、时间敏感逻辑。这些不是靠“框架”解决的,而是靠接口抽象 + 依赖注入。别急着引入 gomock 或 testify,先确认你是否真的需要 mock:多数情况下,用函数变量替换、自定义 http.Client.Transport 或传入 time.Now 函数更轻量、更可控。










