如何用Golang编写单元测试掌握testing包的基础用法-Golang-PHP中文网

如何用Golang编写单元测试掌握testing包的基础用法

P粉602998670

发布： 2025-07-29 11:13:01

原创

308人浏览过

单元测试在go项目中至关重要，使用标准库testing包可提升代码质量。1. 测试文件以_test.go结尾，测试函数以test开头并接收*testing.t参数；2. 通过t.error或t.errorf进行断言，也可使用第三方库增强断言功能；3. 推荐使用表格驱动测试，定义结构体切片包含输入与期望结果，循环执行并验证每组数据，提高可读性、扩展性和错误定位能力；4. 命名规范清晰、避免冗余日志，确保测试稳定可靠。

如何用Golang编写单元测试掌握testing包的基础用法

写单元测试在 Go 项目中是个很基础但又非常重要的事情，尤其是用标准库里的 testing 包。它虽然简单，但用好了能大大提升代码质量。

单元测试的结构和命名规范

Go 的单元测试文件通常以 _test.go 结尾，放在同一个包目录下。测试函数名必须以 Test 开头，后面跟你要测试的函数名（大小写敏感），比如 TestAdd。函数签名应该是这样的：

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

登录后复制

这样命名和组织方式可以让 go test 命令自动识别并运行你的测试用例。

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

常见的做法是把每个被测函数单独写一个测试函数，避免多个测试混在一起不好维护。如果你要测试一些边界情况或者异常输入，可以用表格驱动的方式写，后面会提到。

使用testing包的基本断言方法

Go 的 testing 包本身没有提供像其他语言那样的断言函数（比如 assert.Equal），你需要自己判断条件，并使用 t.Error 或 t.Errorf 来报告错误。

举个例子：

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

登录后复制

虽然看起来有点原始，但这种方式很直接。你也可以配合第三方库（如 testify）来增强断言能力，但在纯 testing 包下，这种方式已经足够清晰。

青柚面试

简单好用的日语面试辅助工具

查看详情

需要注意的是：

如果你想让测试失败后立即停止，可以使用 t.Fatal 或 t.FailNow
不建议在测试中打印太多日志，除非调试时需要，正常跑测试时保持干净输出比较好

表格驱动测试更高效

当你需要测试多种输入输出组合时，表格驱动测试（table-driven tests）是一种很推荐的做法。你可以定义一个结构体切片，里面包含输入和期望结果，然后循环执行测试。

例如：

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

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

登录后复制

这种方法的好处在于：