Go语言单元测试需将测试文件命名为_test.go且与被测代码同包,测试函数以Test开头、接收testing.T参数;支持t.Run子测试、表驱动测试及go test命令运行和覆盖率分析。

在Go语言中编写单元测试非常直接,标准库中的 testing 包提供了完整支持。只要遵循命名规范和结构约定,就能快速为代码添加可靠的测试。
测试文件和函数的命名规则
Go要求测试代码放在以 _test.go 结尾的文件中,且与被测代码在同一包内。测试函数必须以 Test 开头,参数类型为 *testing.T。
例如,如果你有一个文件 math.go,对应的测试文件应命名为 math_test.go。一个典型的测试函数如下:
- 函数名格式:Test + 被测函数名(首字母大写)
- 例如:测试 Add 函数 → TestAdd
- 签名固定为 func TestXxx(t *testing.T)
编写基本的单元测试用例
使用 t.Run 可组织子测试,提升可读性。通过 t.Errorf 或 t.Fatalf 报告错误。
立即学习“go语言免费学习笔记(深入)”;
示例:
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Errorf("期望 5,实际 %d", result)
}
}
使用子测试分组验证多个场景:
func TestAdd(t *testing.T) {
t.Run("正数相加", func(t *testing.T) {
if Add(2, 3) != 5 {
t.Error("正数计算失败")
}
})
t.Run("负数相加", func(t *testing.T) {
if Add(-1, -2) != -3 {
t.Error("负数计算失败")
}
})
}
表驱动测试简化多用例验证
当需要测试多种输入时,推荐使用表驱动方式。将测试用例定义为切片,遍历执行,避免重复代码。
func TestAdd(t *testing.T) {
cases := []struct {
a, b int
expected int
}{
{1, 2, 3},
{0, 0, 0},
{-1, 1, 0},
{100, -50, 50},
}
for _, c := range cases {
t.Run(fmt.Sprintf("%d+%d", c.a, c.b), func(t *testing.T) {
if result := Add(c.a, c.b); result != c.expected {
t.Errorf("期望 %d,实际 %d", c.expected, result)
}
})
}
}
每个测试用例独立运行,输出清晰,便于定位问题。
运行测试和查看覆盖率
在项目目录下执行命令:
- go test —— 运行所有测试
- go test -v —— 显示详细输出
- go test -run TestAdd —— 只运行指定测试
- go test -cover —— 查看代码覆盖率
生成覆盖率报告:
go test -coverprofile=coverage.outgo tool cover -html=coverage.out
这会打开浏览器展示哪些代码被测试覆盖。
基本上就这些。Go的测试机制简洁有效,重点在于坚持写测试、保持高覆盖率,从而提升代码质量。不复杂但容易忽略。










