17370845950

Go 中 table-driven 测试通过结构体切片统一管理测试用例，用 t.Run 实现子测试并推荐具名结构体、语义化字段名、覆盖边界场景，提升可读性、可维护性与调试效率。

在 Go 中，table-driven 测试是组织多个测试用例最清晰、最可维护的方式。它把输入、预期输出和描述封装成结构体切片，用一个循环统一执行断言，避免重复代码，也便于新增或禁用个别用例。

定义测试数据结构

为每个测试用例定义一个匿名或具名结构体，字段通常包括：name（用于日志定位）、input（函数入参）、want（期望结果），以及可选的 errWant（期望错误）。结构体字段名应语义明确，方便阅读。

• 推荐用具名结构体，提高可读性和复用性
• 若逻辑简单，也可直接用匿名结构体切片，减少定义开销
• 避免把断言逻辑塞进结构体字段（比如不存 func() bool），保持数据与行为分离

编写测试函数主体

在 TestXxx 函数中，遍历测试表，对每项调用被测函数，并用 t.Run 创建子测试。子测试名建议包含 tt.name，这样失败时能快速定位具体用例。

• t.Run(tt.name, func(t *testing.T) { ... }) 是关键，支持并发运行、独立计时、单独跳过
• 在子测试内做断言，推荐使用 require 或 assert（来自 testify）提升可读性；原生可用 if got != tt.want { t.Errorf(...) }
• 对错误检查，优先比对错误类型或消息（如用 errors.Is 或 strings.Contains），而非直接 == 错误值

覆盖典型边界与异常场景

一张好的测试表应体现多样性：正常值、零值、空值、超限值、错误输入。例如测试字符串截取函数，可包含：

• 空字符串输入 → 期望返回空字符串
• 长度为 1 的字符串 → 检查索引越界是否返回 error
• 负数起始位置 → 验证是否提前返回错误
• 超出长度的结束索引 → 确认是否自动截断或报错
• 中文字符混合 → 验证 rune 层面处理是否正确（避免 byte 索引误判）

进阶技巧：参数化 setup 和 cleanup

若某些用例需要前置初始化（如创建临时文件、启动 mock server），可在子测试内部按需执行，不影响其他用例。也可借助 t.Cleanup 注册清理逻辑，确保每个子测试收尾干净。

• 避免在循环外做共享 setup，否则用例间可能产生干扰
• 对耗时操作（如网络请求），可结合 t.Parallel() 加速，但需确认被测逻辑线程安全
• 用 //nolint:govet 或 t.Skipf 临时跳过不稳定用例，后续再修复

不复杂但容易忽略的是：给每个 tt.name 起个有信息量的名字，比如 "empty_string_returns_empty" 而不是 "case1" —— 这会让测试输出自带文档属性，调试时省一半力气。