Golang单元测试基础_testing.T的基本用法与断言技巧

testing.t 生命周期限于testxxx函数内，不可跨goroutine或缓存；并发用t.run，闭包需捕获独立变量；清理用t.cleanup而非defer；自定义断言须传*testing.t并调t.helper()。

testing.T 的生命周期和作用域限制

testing.T 不是全局对象，不能缓存、不能跨 goroutine 传递、不能在测试函数返回后继续调用它的方法。一旦 TestXxx 函数退出，t 就失效了。

常见错误现象：panic: test executed after test suite finished，通常是因为在 goroutine 里用了 t.Log 或 t.Fatal 却没等它结束；或者把 *testing.T 存到包级变量里复用。

• 所有断言、日志、跳过操作必须在当前测试函数栈内完成
• 若需并发测试，用 t.Run 启动子测试，并在每个子测试的闭包内使用自己的 t
• 想提前终止当前测试？用 t.Fatal，别用 return + t.Error 组合（后者不会停止执行）

用 t.Run 分组测试时的变量捕获陷阱

Go 的闭包会共享循环变量，直接在 for range 里用 t.Run 容易导致所有子测试跑的都是最后一组数据。

典型错误写法：

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

Lovable

AI辅助编程工具

下载

for _, tc := range tests {
    t.Run(tc.name, func(t *testing.T) {
        if tc.input != tc.want { // 这里的 tc 是同一个地址！
            t.Fail()
        }
    })
}

正确做法是让每个子测试闭包捕获独立副本：

• 显式传参：t.Run(tc.name, func(t *testing.T) { runTest(t, tc) })
• 在循环体内声明新变量：tc := tc（最常用）
• 避免在 t.Run 闭包里读取外部可变状态（比如修改全局 map）

t.Cleanup 比 defer 更适合测试清理

defer 在函数返回时执行，但测试可能被 t.Fatal 中断，此时 defer 不会触发；而 t.Cleanup 注册的函数保证在该测试（含所有子测试）结束前运行，无论成功失败。

适用场景：临时文件创建、端口监听、mock 表态还原、数据库事务回滚。

• 清理逻辑写在 t.Cleanup(func(){...}) 里，不是 defer
• t.Cleanup 可多次调用，按注册逆序执行（LIFO）
• 不要在 t.Cleanup 里调用 t.Fatal 或其他影响测试状态的方法
• 注意：子测试的 Cleanup 只在其自身结束时运行，不影响父测试

自定义断言函数必须接收 *testing.T 并透传

自己封装 assertEqual 或 requireJSON 很常见，但若忘了把 *testing.T 传进去，会导致断言失败时不终止测试，后续代码继续执行，掩盖真实问题。

错误示例：assertEqual(got, want) 内部只调 fmt.Println —— 测试不会失败。

• 所有断言函数签名必须是 func(t *testing.T, ...)
• 内部要用 t.Helper() 标记辅助函数，这样 t.Error 报错位置才指向调用处，而不是断言函数内部
• 区分 t.Error（继续执行）和 t.Fatal（立即终止），按语义选；require 类行为应选 Fatal
• 别为了“统一风格”把 t.Log 和 t.Error 合并成一个函数——日志和失败语义不同，混用会干扰调试