Golang测试教程：testing包基础用例详解

本文介绍了如何使用 Go 语言自带的 `testing` 包编写单元测试，这是保证 Go 项目质量的基础且重要环节。文章从单元测试的基础结构入手，讲解了如何创建以 `_test.go` 结尾的测试文件，并使用 `TestXxx` 格式命名测试函数。重点介绍了使用 `t.Errorf` 报告错误，以及推荐使用表组测试(`Table-driven Tests`)方式来清晰地管理多组测试用例，提升测试代码的可读性和可维护性。此外，还简要介绍了如何通过 `BenchmarkXxx` 函数进行性能测试，帮助开发者评估代码性能。掌握这些基础知识，即可编写出清晰、可维护的 Go 语言单元测试，有效提升项目质量。

Go语言中使用testing包编写单元测试的基础结构是创建以TestXxx开头的函数并接受*testing.T参数；具体步骤包括：1. 创建\_test.go结尾的测试文件；2. 使用Test前缀加首字母大写命名测试函数；3. 用t.Errorf报告错误；4. 推荐使用表组测试方式管理多组测试用例；5. 可通过BenchmarkXxx函数实现性能测试。

写单元测试在 Go 项目中是非常基础但重要的事情，而 testing 包就是官方提供的标准工具。它虽然简洁，但功能足够应对大多数场景。下面我们就来看看怎么用 testing 包来写基础的单元测试。

基础结构：一个测试函数长什么样？

Go 的单元测试函数一般以 TestXxx 开头，并接受一个 *testing.T 参数。这个命名规则是强制性的，否则 go test 不会识别。

比如有一个简单的加法函数：

// add.go
package main

func Add(a, b int) int {
    return a + b
}

对应的测试文件应该是 add_test.go，内容如下：

// add_test.go
package main

import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("期望结果为5，实际得到 %d", result)
    }
}

注意几点：

• 测试文件名必须以 _test.go 结尾。
• 测试函数名以 Test 开头，后面跟大写字母。
• 使用 t.Errorf 来报告错误，这样不会立刻停止测试，而是记录错误后继续执行。

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

当你要测试多个输入输出组合时，可以使用“表组测试”方式。这种方式很常见，也非常推荐，因为它结构清晰、容易维护。

还是上面的例子，我们可以扩展测试用例：

func TestAdd(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        expected int
    }{
        {"2+3=5", 2, 3, 5},
        {"0+0=0", 0, 0, 0},
        {"-1+1=0", -1, 1, 0},
        {"最大值测试", 1<<30, 1<<30, 2 << 30},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            result := Add(tt.a, tt.b)
            if result != tt.expected {
                t.Errorf("期望 %d，实际得到 %d", tt.expected, result)
            }
        })
    }
}

这里的关键点：

• 使用结构体定义多个测试用例。
• 使用 t.Run() 执行每个子测试，带名字，便于定位失败用例。
• 可读性好，增删改都很方便。

性能测试：Benchmark 也很简单

除了功能测试，testing 包还支持性能测试。只需要写一个 BenchmarkXxx 函数，里面调用被测函数多次即可。

例如：

func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {
        Add(100, 200)
    }
}

运行命令：

go test -bench=.

输出类似：

BenchmarkAdd-8    1000000000           0.25 ns/op

说明每轮操作平均耗时 0.25 纳秒。这对性能敏感的代码非常有用。

基本上就这些了。Go 的 testing 包虽然看起来简单，但已经能满足绝大多数项目的测试需求。只要掌握基本结构和表组测试模式，就能写出清晰、可维护的测试代码。

终于介绍完啦！小伙伴们，这篇关于《Golang测试教程：testing包基础用例详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！