当前位置：首页 > 文章列表 > Golang > Go教程 > Golang测试库使用教程：单元测试入门指南

Golang测试库使用教程：单元测试入门指南

2026-04-14 21:16:38 0浏览收藏

本文系统讲解了 Go 语言单元测试的核心实践：从最基础的测试函数规范（_test.go 文件、TestXxx 命名、*testing.T 参数）到常见陷阱规避，涵盖 go test 命令的实用参数（-v、-run、-count）、清晰可维护的表驱动测试写法（t.Run + 结构体切片 + 防闭包陷阱），并明确解答了“是否需导出私有函数以供测试”这一高频困惑——强调同包测试可直接访问未导出成员，同时提醒注意全局状态污染与 t.Cleanup 的正确使用，为编写可靠、易读、易扩展的 Go 测试打下扎实根基。

Golang testing标准库怎么写测试_Golang单元测试基础

怎么用 `testing.T` 写最简测试函数

Go 的测试必须放在以 _test.go 结尾的文件里，函数名以 Test 开头、接收 *testing.T 参数。不满足这三点，go test 直接忽略。

常见错误是把测试函数写成 func TestAdd()（缺参数）或 func testAdd(t *testing.T)（没大写），结果运行 go test 显示 no tests to run。

测试文件必须和被测代码在同一个包（不用 import，直接调）
函数签名严格为 func TestXxx(t *testing.T)，Xxx 首字母大写
用 t.Errorf() 报告失败，t.Fatal() 会终止当前测试函数

func TestAdd(t *testing.T) {
    got := Add(2, 3)
    want := 5
    if got != want {
        t.Errorf("Add(2, 3) = %d, want %d", got, want)
    }
}

`go test` 常见执行方式和关键参数

默认只跑当前目录下所有 *_test.go 中的 Test 函数。不加参数时，它不会递归子目录，也不会运行 Benchmark 或 Example 函数。

go test：运行当前包测试，成功无输出（加 -v 才显示每个测试名和结果）
go test -v：显示测试过程，失败时自动打印 t.Log() 和错误堆栈
go test -run=^TestAdd$：只跑 TestAdd（^ 和 $ 是正则锚点，避免匹配到 TestAddWithNegative）
go test -count=1：强制只跑一次（默认会缓存并跳过重复测试）

注意：go test ./... 会递归所有子目录，但若某子目录没有测试文件，会报 no buildable Go source files —— 这不是错误，只是提示，不影响其他包测试执行。

表驱动测试怎么组织才不容易漏 case

Go 官方推荐用切片定义测试用例，配合 t.Run() 做子测试。好处是失败时能精确定位到哪个输入组合出问题，而且 range 循环本身不会因单个 case 失败而中断后续 case。

每个子测试名建议可读，比如用 fmt.Sprintf("input_%d_%d", a, b)
别在循环里直接用循环变量做断言（闭包陷阱），要复制值或用索引访问
如果某个 case 需要提前返回（比如涉及资源 cleanup），用 t.Fatal；仅记录错误用 t.Error

func TestAddTable(t *testing.T) {
    tests := []struct {
        a, b, want int
    }{
        {0, 0, 0},
        {1, -1, 0},
        {100, 200, 300},
    }
    for _, tt := range tests {
        t.Run(fmt.Sprintf("Add(%d,%d)", tt.a, tt.b), func(t *testing.T) {
            got := Add(tt.a, tt.b)
            if got != tt.want {
                t.Errorf("got %d, want %d", got, tt.want)
            }
        })
    }
}