最简测试函数需满足三点:文件名以_test.go结尾、函数名以test开头、参数为testing.t;例如func testadd(t testing.t) { got := add(2, 3); want := 5; if got != want { t.errorf("add(2, 3) = %d, want %d", got, want) } }。

怎么用 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 —— 这不是错误,只是提示,不影响其他包测试执行。
立即学习“go语言免费学习笔记(深入)”;
表驱动测试怎么组织才不容易漏 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)设计了。










