Go 表驱动测试默认不支持按索引或名称单独运行某个测试用例，但自 Go 1.7 起可通过 t.Run() 创建命名子测试，结合 -run 参数实现精确筛选；Go 1.6 及更早版本则可通过自定义 flag 实现类似功能。
go 表驱动测试默认不支持按索引或名称单独运行某个测试用例，但自 go 1.7 起可通过 `t.run()` 创建命名子测试，结合 `-run` 参数实现精确筛选；go 1.6 及更早版本则可通过自定义 flag 实现类似功能。
在 Go 测试实践中，表驱动测试（table-driven tests）是组织大量测试用例的推荐方式——它将输入、期望输出和可选描述封装在结构体切片中，避免重复编写相似的 t.Run() 或独立测试函数。然而，传统循环遍历方式存在调试痛点：新增用例后无法像普通测试函数一样通过 go test -run TestName/CaseName 快速定位并执行单个用例。
幸运的是，Go 官方从 1.7 版本起原生支持子测试（subtests），这为表驱动测试带来了革命性的调试能力。
✅ 推荐方案：使用 t.Run() 构建可筛选的子测试（Go ≥ 1.7）
只需将每个测试用例包装为一个命名子测试，即可利用 go test -run 的层级匹配能力：
func TestMyFn(t *testing.T) {
cases := []struct {
arg, expected string
}{
{"%a", "[%a]"},
{"%-a", "[%-a]"},
{"%+a", "[%+a]"},
{"%#a", "[%#a]"},
}
for i, c := range cases {
// 动态生成子测试名，建议包含语义信息（如索引、简短描述）
name := fmt.Sprintf("Case%d_%s", i, strings.ReplaceAll(c.arg, "%", "PCT"))
t.Run(name, func(t *testing.T) {
res := myfn(c.arg)
if res != c.expected {
t.Errorf("myfn(%q) = %q, want %q", c.arg, res, c.expected)
}
})
}
}
✅ 运行指定用例：
go test -run TestMyFn/Case2 # 运行第3个用例（索引为2） go test -run TestMyFn/PCT#a # 匹配含 "PCT#a" 的子测试名 go test -run /Case0 # 运行所有顶层测试中名称含 "Case0" 的子测试
? 提示：子测试名支持任意合法字符串，建议兼顾可读性与唯一性。避免仅用纯数字（如 "0"），易与其他测试冲突；推荐 "Case0_ArgX" 或 "Valid_SimpleFormat" 等语义化命名。
Codex Sub Agents 1下载使用 OpenAI Codex CLI 处理编码任务。触发词：codex、code review、fix CI、refactor code、implement feature、coding agent、gpt-5-codex。Clawdbot 可将编码工作委托给 Codex CLI 作为子代理或直接工具。
⚠️ 兼容方案：自定义 flag 实现索引过滤（Go
若项目仍需兼容旧版 Go，可借助 flag 包注入命令行参数（注意：go test 已自动调用 flag.Parse()，无需显式初始化）：
import "flag"
var testCaseIndex = flag.Int("testcase", -1, "run only test case at given index (0-based)")
func TestMyFn(t *testing.T) {
cases := [...]struct{ arg, expected string }{
{"%a", "[%a]"},
{"%-a", "[%-a]"},
{"%+a", "[%+a]"},
}
for i, c := range cases {
if *testCaseIndex != -1 && i != *testCaseIndex {
t.Log("Skipping test case", i)
continue
}
res := myfn(c.arg)
if res != c.expected {
t.Errorf("myfn(%q) = %q, want %q", c.arg, res, c.expected)
}
}
}
运行方式：
go test -testcase=1 # 仅执行索引为 1 的用例
⚠️ 注意：该方式不兼容 go test -v 的标准测试输出格式（子测试不会显示为独立条目），且无法与 -run 组合使用。仅作为过渡方案，强烈建议升级至 Go 1.7+ 并采用子测试。
? 最佳实践总结
- 优先使用子测试：t.Run() 是官方推荐、可组合、可嵌套、支持并发（t.Parallel()）、支持独立失败标记的现代方案。
- 命名即文档：子测试名应反映测试意图（如 "EmptyInput", "InvalidPattern_Error"），而非仅用索引。
- 避免全局状态污染：每个子测试函数内应独立完成 setup/teardown，不依赖外部变量或共享状态。
- 结合 t.Skip() 增强可维护性：对临时跳过的用例，可用 t.Skip("WIP: needs fix") 替代注释掉代码，保持测试结构完整。
通过子测试机制，表驱动测试不再只是“批量执行”的工具，而成为兼具高可维护性、高可调试性与清晰可读性的工程化测试范式。
