Golang如何使用testing包编写单元测试_Golang testing单元测试编写方法

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

示例:

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 包写出清晰可靠的单元测试。不复杂但容易忽略细节。