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

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

怎么用 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)
            }
        })
    }
}

测试私有函数要不要导出

不需要。Go 的测试文件和源文件在同一包内，可以直接调用未导出（小写开头）的函数、变量、方法。这是 Go 测试机制的设计前提。

强行导出私有函数只为测试，反而破坏封装，还可能被外部误用。唯一要注意的是：如果私有函数依赖包级变量或状态（比如全局 map、计数器），测试之间可能互相污染 —— 这时应在每个测试开始前重置状态，或用 t.Cleanup() 恢复。

• 测试文件和源文件同包 → 可直接访问未导出标识符
• 避免在多个测试间共享可变全局状态
• 用 t.Cleanup(func(){ ... }) 注册清理逻辑，确保无论成功失败都会执行

真正难测的往往不是函数本身，而是它隐式依赖的外部行为（如时间、随机数、文件系统）。这些需要抽象成接口或函数变量，再在测试中替换 —— 但这已经超出标准库 testing 范围，属于测试替身（test double）设计了。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。