Golang初学者如何编写单元测试 介绍testing包的基础测试模式

编写单元测试是提升代码质量的关键方式，golang的testing包提供了基础支持。1. 测试文件以_test.go结尾，测试函数以test开头并接受*testing.t参数；2. 使用t.error或t.errorf记录错误，用t.fatalf终止测试；3. 表组测试通过结构体切片管理多组输入输出组合；4. 子测试使用t.run方法提高可读性和隔离性，便于定位问题。掌握这些要点能有效写出结构清晰、易于维护的单元测试。

写单元测试是提升代码质量的重要手段，Golang自带的 testing 包就是为这个目的设计的。对于初学者来说，掌握它的基础用法并不难，关键是理解怎么组织测试结构和使用常用方法。

编写测试函数的基本格式

在 Go 中，每个测试文件的名字都以 _test.go 结尾，测试函数必须以 Test 开头，并接受一个 *testing.T 类型的参数。比如：

func TestAdd(t *testing.T) {
    // 测试逻辑
}

这个格式是强制性的，Go 工具链会自动识别并运行这些测试函数。你可以把测试文件放在与被测代码相同的目录中，通常推荐和源文件同名加 _test.go 后缀，比如 add.go 对应 add_test.go。

立即学习“go语言免费学习笔记（深入）”；

使用 t.Error 和 t.Fatalf 报告错误

测试的核心在于验证行为是否符合预期。如果实际结果和期望不符，可以用 t.Error 或 t.Errorf 来记录错误，但测试还会继续执行后续逻辑。如果你希望一旦出错就立刻停止，可以用 t.Fatalf。

举个例子：

func TestAdd(t *testing.T) {
    got := add(2, 3)
    want := 5

    if got != want {
        t.Errorf("add(2,3) = %d; want %d", got, want)
    }
}

这里用了 t.Errorf 输出具体的错误信息，方便定位问题。记住一点：不要只写“结果不对”，要说明期望值和实际值，这样更容易排查。

表组测试（Table-driven Tests）让测试更清晰

当你需要测试多个输入输出组合时，表组测试是个好办法。它通过定义一个结构体切片来保存每组测试数据，然后循环执行。

示例：

func TestAdd(t *testing.T) {
    tests := []struct {
        a, b int
        want int
    }{
        {2, 3, 5},
        {0, 0, 0},
        {-1, 1, 0},
    }

    for _, tt := range tests {
        got := add(tt.a, tt.b)
        if got != tt.want {
            t.Errorf("add(%d, %d) = %d; want %d", tt.a, tt.b, got, tt.want)
        }
    }
}

这种方式有几个好处：

• 易于添加新的测试用例
• 错误信息统一、结构清晰
• 可以配合子测试一起使用（后面再讲）

子测试（Subtests）提高可读性和隔离性

有时候你想对某个函数的不同情况分别测试，并希望它们单独显示在测试报告中，就可以使用子测试。

改造上面的例子：

func TestAdd(t *testing.T) {
    tests := map[string]struct {
        a, b int
        want int
    }{
        "positive numbers": {2, 3, 5},
        "zeros":            {0, 0, 0},
        "negative and positive": {-1, 1, 0},
    }

    for name, tt := range tests {
        t.Run(name, func(t *testing.T) {
            got := add(tt.a, tt.b)
            if got != tt.want {
                t.Errorf("got %d, want %d", got, tt.want)
            }
        })
    }
}

t.Run 的第一个参数是子测试名称，会在测试输出中显示出来。这样你就能一眼看出哪一组失败了，而不会混在一起。

基本上就这些内容了。掌握了基本的测试函数写法、错误报告方式、表组测试和子测试，你就已经能写出结构良好、易于维护的单元测试了。这些做法虽然看起来简单，但在实际项目中非常实用，而且是很多团队的标准实践。

以上就是Golang初学者如何编写单元测试 介绍testing包的基础测试模式的详细内容，更多请关注php中文网其它相关文章！