Golang单元测试教程：testing包入门指南

**Golang单元测试编写教程：testing包基础用法详解** 本文深入讲解了Go语言中使用`testing`包进行单元测试的基础知识和实用技巧。通过创建以`TestXxx`开头的函数并接收`*testing.T`参数，即可开始编写测试用例。文章详细介绍了单元测试的基本结构，包括如何创建`_test.go`结尾的测试文件，如何使用`Test`前缀命名测试函数，以及如何利用`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学习网公众号！