Go语言中testing包用于编写单元测试,需遵循命名规范:测试文件以_test.go结尾,测试函数以Test开头并接收*testing.T参数。通过t.Error和t.Fatalf报告错误,后者会中断测试。推荐使用表驱动测试,将多个用例组织为结构体切片,并用t.Run命名子测试以便定位失败。运行测试可用go test命令,加-v参数显示详细日志,-run指定特定测试,-cover查看覆盖率,结合-coverprofile和tool cover生成HTML报告。合理运用这些特性可写出清晰可靠的测试代码。

在Go语言中,testing 包是标准库中用于编写单元测试的核心工具。它无需额外依赖,只需遵循简单的约定即可为代码编写高效、可运行的测试。
测试文件和函数命名规则
Go 的测试文件必须以 _test.go 结尾,且与被测代码放在同一包中。测试函数名必须以 Test 开头,函数参数类型为 *testing.T。
例如,若有一个文件 calculator.go,对应的测试文件应命名为 calculator_test.go。
示例:
立即学习“go语言免费学习笔记(深入)”;
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("Add(2, 3) = %d; want 5", result)
}
}
使用 t.Error 和 t.Fatalf 报告错误
当测试不满足预期时,使用 t.Error 输出错误信息并继续执行,而 t.Fatalf 会中断当前测试。
建议在关键断言失败后使用 t.Fatalf 避免后续无效执行。
- t.Errorf("期望 %d,实际得到 %d", expected, actual)
- t.Fatalf("初始化失败,无法继续测试")
表驱动测试(Table-Driven Tests)
Go 推荐使用表驱动方式测试多个输入用例,结构清晰且易于扩展。
将测试用例组织成切片,每个元素包含输入和期望输出。
func TestMultiply(t *testing.T) {
tests := []struct {
name string
a, b int
expected int
}{
{"正数相乘", 2, 3, 6},
{"乘以零", 5, 0, 0},
{"负数相乘", -2, 4, -8},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
result := Multiply(tt.a, tt.b)
if result != tt.expected {
t.Errorf("got %d, want %d", result, tt.expected)
}
})
}
}
使用 t.Run 可为每个子测试命名,便于定位失败用例。
运行测试和覆盖率检查
在项目根目录执行以下命令运行测试:
- go test:运行当前包的所有测试
- go test -v:显示详细输出,包括 t.Log 打印的信息
- go test -run TestName:运行特定测试函数
- go test -cover:查看测试覆盖率
生成覆盖率报告文件并查看详情:
go test -coverprofile=coverage.out go tool cover -html=coverage.out
基本上就这些。只要遵循命名规范,合理组织测试用例,就能用 Go 的 testing 包写出清晰可靠的单元测试。不复杂但容易忽略细节。










