Go语言单元测试怎么写_使用testing包编写基础测试

go单元测试需严格遵循约定：函数名以Test开头且首字母大写，参数为*testing.T，无返回值，文件名以_test.go结尾；用t.Errorf/t.Fatal报告失败，私有函数同包直接调用，推荐表驱动测试配合t.Run子测试。

Go 语言的单元测试不需要第三方框架，testing 包开箱即用，但写法和习惯与其他语言差异较大——测试函数必须以 Test 开头、接收 *testing.T 参数、不能返回值，否则 go test 根本不会识别。

测试函数命名和签名必须严格符合约定

Go 不靠注解或配置发现测试，只靠函数名前缀和签名匹配。任意偏差都会导致测试被跳过，且无提示。

• 函数名必须以 Test 开头，后接**大写字母开头**的有意义名称（如 TestAdd，不能是 testAdd 或 Test_add）
• 参数有且仅有一个，类型为 *testing.T
• 返回值必须为空（不能写 error 或 bool）
• 文件名必须以 _test.go 结尾（如 calc_test.go），且与被测代码在同一个包内

用 t.Errorf 和 t.Fatal 报告失败，别用 panic 或 log

测试中出错不能靠 panic 或 log.Fatal 终止，否则 go test 无法捕获上下文、不计入失败统计，还会中断整个测试流程。

• t.Errorf("msg")：记录错误，当前测试继续执行（适合检查多个断言）
• t.Fatal("msg")：记录错误并立即终止当前测试函数（适合前置条件不满足，如 setup 失败）
• 不要用 fmt.println 或 log.Print 输出“成功”信息——go test 默认只显示失败输出，加 -v 才看 t.Log

测试私有函数要放在同一包下，不是“反射调用”

Go 没有“测试专用访问权限”。想测 func calculate(...)（小写开头），就把它和测试函数一起放在 calc.go 和 calc_test.go 中，同属 calc 包。测试文件里直接调用即可。

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

常见误解是把测试放到 calc_test 独立包里再 import 原包——那样只能访问导出（大写开头）的标识符，私有函数根本不可见。

func TestCalculate(t *testing.T) {     result := calculate(2, 3) // 直接调用私有函数，因为同包     if result != 5 {         t.Errorf("expected 5, got %d", result)     } }

表驱动测试比多个 Test 函数更清晰、易维护

对同一函数做多组输入/输出验证时，硬写多个 TestXxx1、TestXxx2 会导致重复代码、难以扩展。推荐用结构体切片 + range 循环。

• 每个测试用例包含 name（用于 t.Run 子测试）、input、expected
• 用 t.Run(name, func(t *testing.T) {...}) 隔离子测试，失败时能精准定位是哪一组数据出问题
• 避免在循环里直接用 i 或闭包变量，要显式传参或赋值给局部变量

func TestAdd(t *testing.T) {     tests := []struct {         name     string         a, b     int         expected int     }{         {"positive", 1, 2, 3},         {"zero", 0, 0, 0},         {"negative", -1, -1, -2},     }     for _, tt := range tests {         t.Run(tt.name, func(t *testing.T) {             if got := Add(tt.a, tt.b); got != tt.expected {                 t.Errorf("Add(%d,%d) = %d, want %d", tt.a, tt.b, got, tt.expected)             }         })     } }

最容易被忽略的是子测试（t.Run）的使用场景：当测试逻辑含初始化、资源清理或并发验证时，它能避免变量污染和 panic 传播；而很多人写完第一个 t.Errorf 就停了，没意识到后续校验可能同样重要。