使用testing.T可控制测试流程:通过Fail、Error标记失败,Fatal立即终止;Skip跳过特定测试;Run创建子测试以实现层级化组织。

在 Golang 中,testing.T 是控制测试执行流程的核心类型。它不仅用于断言和记录日志,还能主动管理测试的终止、跳过与子测试的组织。合理使用 *testing.T 提供的方法,可以让测试更清晰、健壮且易于维护。
终止测试:Fail、Fatal 与 Error
当测试中出现不符合预期的情况时,需要通过不同的方式通知测试框架:
- T.Fail():标记当前测试为失败,但继续执行后续语句
- T.Errorf(format, args...):输出错误信息并标记失败,等价于 Logf + Fail
- T.Fatal(args...):立即终止当前测试函数,常用于前置条件不满足时
例如,在检查 API 响应时发现关键字段为空,可以直接中断:
func TestUserAPI(t *testing.T) {resp := getUser() // 模拟请求
if resp == nil {
t.Fatal("response is nil, cannot proceed")
}
if resp.ID == 0 {
t.Error("expected non-zero ID")
}
}
跳过测试:Skip 与条件判断
某些测试可能只在特定环境下运行(如集成测试依赖数据库),可以使用 Skip 跳过:
立即学习“go语言免费学习笔记(深入)”;
- T.Skip(reason):立即停止执行当前测试,标记为已跳过
- T.SkipNow():无参数跳过
常见用法是结合环境变量或长运行标志:
func TestDatabaseIntegration(t *testing.T) {if testing.Short() {
t.Skip("skipping DB test in short mode")
}
// 继续数据库操作... }
组织子测试:Run 与层级控制
Go 支持通过 T.Run() 创建子测试,便于分组和独立运行:
- go test -run=TestParse/valid_input
示例:对 JSON 解析函数进行多场景测试:
func TestParseJSON(t *testing.T) {tests := map[string]struct {
input string
valid bool
}{ "valid_input": {`{"name":"bob"}`, true}, "invalid_json": {`{name:}`, false}, }
for name, tc := range tests {
t.Run(name, func(t *testing.T) {
_, err := parseJSON(tc.input)
if tc.valid && err != nil {
t.Error("expected no error")
} else if !tc.valid && err == nil {
t.Error("expected error")
}
})
} }
资源清理与辅助方法
测试中常需创建临时文件、启动 mock 服务等,应使用 T.Cleanup() 注册清理函数:
- Cleanup 确保无论测试成功或失败都会执行释放逻辑
- 适合关闭文件、取消定时器、重置全局状态
例子:
func TestWithTempDir(t *testing.T) {dir := t.TempDir() // 自动清理
file := filepath.Join(dir, "config.json")
err := os.WriteFile(file, []byte("{}"), 0644)
if err != nil {
t.Fatal(err)
}
// 不用手动删除,t.TempDir 已注册清理 }
基本上就这些。掌握 *testing.T 的流程控制能力,能让 Go 测试更灵活可靠。关键是根据场景选择合适的终止、跳过和组织方式,避免误用 Fatal 导致信息丢失,同时善用子测试提升可读性。










