Golang测试基础：testing包使用详解

掌握Golang单元测试，提升代码质量！本文详细介绍了Go语言testing包的使用，助你快速上手单元测试。从测试文件的命名规则（`xxx_test.go`）到测试函数的编写（`func TestXxx(t *testing.T)`），再到错误报告（`t.Errorf`、`t.Fatalf`），一一讲解。重点推荐表驱动测试，并通过`t.Run`创建子测试，有效提高测试用例的可维护性和可读性。通过`go test`命令运行测试，`-v`参数查看详细结果，确保代码的正确性。本文提供清晰的示例代码和运行结果，助你轻松掌握Golang单元测试的核心技巧，编写高质量的Go代码。

Go语言单元测试通过testing包实现，测试文件命名为xxx_test.go且与被测文件同包，测试函数以Test开头并接收*testing.T参数，使用t.Errorf或t.Fatalf报告错误，推荐采用表驱动测试方式并通过t.Run创建子测试以提高可维护性和可读性，运行go test命令执行测试并用-v参数查看详细结果，最终确保代码正确性。

编写 Go 语言的单元测试非常简单，标准库中的 testing 包提供了完整的支持。下面通过一个基础示例，展示如何为一个简单的函数编写单元测试。

1. 被测试函数示例

假设我们有一个计算两个整数之和的函数，放在 math.go 文件中：

// math.go
package main

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

2. 编写对应的测试文件

Go 的测试文件命名规则是：_test.go，且与被测文件在同一个包中。创建 math_test.go：

// math_test.go
package main

import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    expected := 5

    if result != expected {
        t.Errorf("Add(2, 3) = %d; expected %d", result, expected)
    }
}

说明：

• 测试函数名必须以 Test 开头，可选后接大写字母或单词（如 TestAdd, TestAddNegative）。
• 参数 t *testing.T 是测试的上下文，用于记录错误、控制测试流程。
• 使用 t.Errorf 报告错误，测试会标记为失败，但继续执行；t.Fatalf 会中断测试。

3. 运行测试

在项目目录下执行：

go test

输出应为：

PASS
ok      your-project-name    0.001s

如果想看更详细的信息，加上 -v 参数：

go test -v

输出类似：

=== RUN   TestAdd
--- PASS: TestAdd (0.00s)
PASS
ok      your-project-name    0.001s

4. 添加更多测试用例（表驱动测试）

对于多个输入组合，推荐使用“表驱动测试”（table-driven test），更清晰、易维护：

// math_test.go
func TestAdd(t *testing.T) {
    tests := []struct {
        name     string
        a, b     int
        expected int
    }{
        {"positive numbers", 2, 3, 5},
        {"negative numbers", -2, -3, -5},
        {"mixed signs", -2, 3, 1},
        {"zero", 0, 0, 0},
    }

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

说明：

• 使用 t.Run 创建子测试，每个测试用例独立运行。
• 输出中会显示每个子测试的名称，便于定位失败项。

运行结果示例：

=== RUN   TestAdd
=== RUN   TestAdd/positive_numbers
=== RUN   TestAdd/negative_numbers
=== RUN   TestAdd/mixed_signs
=== RUN   TestAdd/zero
--- PASS: TestAdd (0.00s)
    --- PASS: TestAdd/positive_numbers (0.00s)
    --- PASS: TestAdd/negative_numbers (0.00s)
    --- PASS: TestAdd/mixed_signs (0.00s)
    --- PASS: TestAdd/zero (0.00s)
PASS

小结

• 测试文件命名：xxx_test.go
• 测试函数：func TestXxx(t *testing.T)
• 使用 t.Error 或 t.Fatal 报告错误
• 推荐使用表驱动测试处理多用例
• 用 t.Run 组织子测试，提升可读性

基本上就这些。Go 的测试机制简洁直接，配合 go test 命令即可快速验证代码正确性。

以上就是《Golang测试基础：testing包使用详解》的详细内容，更多关于的资料请关注golang学习网公众号！