Go 测试强调手动断言与清晰失败报告,推荐用 t.Errorf 显示输入、期望值和实际值;前置失败用 t.Fatal 终止;用 t.Run 组织场景化子测试;通过依赖注入、接口抽象和 t.TempDir 验证副作用。

Go 的 testing.T 本身不提供内置断言函数(如 assert.Equal),行为验证靠开发者手动判断 + t.Error / t.Fatal 实现。关键不是“用什么断言库”,而是如何清晰、可靠、可维护地表达“期望 vs 实际”。
用 t.Errorf 清晰报告失败细节
避免只写 t.Error("failed"),应包含:输入、期望值、实际值、上下文。这样一次失败就能定位问题,无需额外调试。
- ✅ 推荐写法:
t.Errorf("ParseTime(%q) = %v, want %v", input, got, want) - ❌ 避免写法:
if got != want { t.Error("wrong result") } - 对结构体或长文本,可用
fmt.Sprintf("%+v", x)或spew.Sdump(x)(需引入 github.com/davecgh/go-spew/spew)增强可读性
用 t.Fatal 及时终止不可继续的测试
当前置条件失败(如资源未就绪、依赖未启动)或核心状态已损坏时,用 t.Fatal 立即停止当前测试函数,避免后续误判或 panic。
- 例如:打开测试文件失败、启动 mock HTTP server 失败、数据库迁移未完成
-
t.Fatal输出错误后直接 return;t.Fatalf支持格式化,更常用 - 注意:不要在循环中滥用
t.Fatal—— 它会跳过该测试内剩余逻辑,如需检查多个用例,请用子测试(t.Run)隔离
用 t.Run 组织场景化行为验证
把一类行为拆成多个命名子测试,每个验证一个明确契约(如 “空输入返回零值”、“超长字符串截断处理”、“并发调用不 panic”)。这既是行为驱动(BDD)风格,也利于失败时快速归因。
立即学习“go语言免费学习笔记(深入)”;
- 示例结构:
t.Run("returns error when URL is empty", func(t *testing.T) { ... })t.Run("handles timeout gracefully", func(t *testing.T) { ... })- 子测试可独立运行:
go test -run="TestFetchURL/timeout" - 共享 setup/teardown 可放在子测试外,或用闭包捕获局部变量
验证副作用与行为,不止看返回值
真实行为常涉及状态变更、日志输出、HTTP 调用、文件写入等。需设计可观察点(observability point)来验证:
- 依赖注入:把 logger、client、storage 等作为参数传入被测函数,测试时传入记录器(如
bytes.Buffer捕获日志)或 mock 客户端 - 接口抽象:定义
Sender接口替代直接调用http.Post,测试时实现内存版MockSender记录调用参数 - 临时目录:用
t.TempDir()创建自动清理的目录,验证文件是否按预期生成/内容是否正确
基本上就这些 —— Go 测试的威力不在语法糖,而在你如何用 t.Log、t.Error、t.Run 和良好设计把“它应该做什么”写成可执行、可阅读、可演化的代码契约。










