当前位置：首页 > 文章列表 > Golang > Go教程 > Golang测试教程：掌握testing包基础用法

Golang测试教程：掌握testing包基础用法

2025-07-21 13:00:38 0浏览收藏

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Golang单元测试教程：掌握testing包基础用法》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

单元测试在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 命令自动识别并运行你的测试用例。

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

使用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)
        }
    }
}

这种方法的好处在于：