Go test 怎么用 -run 和 -count 精确重跑一个测试

只想重跑一个 Go 测试时，最实用的命令通常是：

# -run 负责筛选，-count=1 负责绕过成功结果缓存
go test ./path/to/pkg -run '^TestParseConfig$' -count=1 -v

如果目标是某个子测试，可以写成 -run '^TestParseConfig$/^valid$'。需要连续观察偶发失败时，把它改成 -count=20。关键是把三件事分开：-run 决定匹配谁，-count 决定跑几次，-count=1 还会明确关闭包列表模式下的成功测试缓存。

想精确重跑一个测试，先用 -run 写出唯一匹配，再加 -count=1 排除缓存；需要观察偶发问题时改用更大的 -count，并保留 -v 记录每次结果。

先用 -run 锁定测试名和子测试

-run 接收正则表达式，不是“按文件名查找”。例如包里有 TestParseConfig、TestParseConfigFromEnv，直接写 -run ParseConfig 可能同时命中两个测试。只想运行一个顶层测试时，给名称加上正则边界：

# ^ 和 $ 让匹配范围停在这个测试函数名
go test ./config -run '^TestParseConfig$' -v

测试函数内部如果使用了 t.Run，可以继续匹配子测试：

func TestParseConfig(t *testing.T) { // 父测试承载多个场景
	t.Run("valid", func(t *testing.T) { // 目标子测试名称
		// 这里放合法配置的断言
	})
	t.Run("missing", func(t *testing.T) { // 另一个场景
		// 这里放缺少字段的断言
	})
}

# 未转义的 / 把父测试和子测试分成两段正则
go test ./config -run '^TestParseConfig$/^valid$' -v

Go 的测试匹配会按未加括号保护的斜杠分段。父测试可能仍然出现一次，因为测试框架需要启动它来发现子测试；这不等于 missing 也被选中了。

理解 -run 精确匹配时的父测试行为

排查“为什么输出里还有父测试”时，先看测试名层级，而不是马上改正则。-run '^TestParseConfig$' 匹配父测试本身，父测试里的所有 t.Run 都可能由代码逻辑决定是否创建；-run '^TestParseConfig$/^valid$' 才是在父层和子层都进行筛选。

可以先用 -list 查看顶层测试名称，再把结果放进 -run。不要把一段输出里出现了父测试名，误判成所有子测试都被重复执行。对共享环境、随机种子或并行子测试，还要结合测试代码确认真正的隔离边界。

用 -count=1 关闭成功结果缓存

当命令带有包参数，例如 go test ./... 或 go test ./config，Go 会在满足条件时复用成功的测试结果，摘要可能显示 (cached)。这对日常开发很快，但不适合验证刚修改的外部文件、环境变量或偶发状态。

# 显式禁用成功测试缓存，只运行选中的顶层测试
go test ./config -run '^TestParseConfig$' -count=1 -v

这里的 -count=1 不表示“只允许测试执行一次”这么简单，它同时是官方文档推荐的显式禁用缓存写法。若不带包参数、直接在当前目录运行 go test，属于本地目录模式，本身就不使用测试缓存；为了让命令意图更清楚，团队脚本仍可以保留 -count=1。

用 -count=N 重复验证不稳定测试

要观察一个测试是否偶发失败，可以把筛选和重复次数合在一起：

# 对同一个子测试重复 20 次，并输出每次测试日志
go test ./config -run '^TestParseConfig$/^valid$' -count=20 -v

-count=N 会让每个匹配的测试、基准或 fuzz seed 运行 N 次；示例只涉及普通测试。重复运行能暴露时间依赖、共享文件、全局变量和随机数据问题，但不能证明代码已经稳定。若测试调用了 t.Parallel()，还要关注测试内部并发与包级并行带来的干扰。

一个可复用的检查顺序是：先用 ^...$ 确认选中了谁，再用 -count=1 排除缓存，最后用 -count=20 -v 观察真实重复结果。若失败，保存失败次数、测试名和相关日志，回到测试的共享状态或清理逻辑定位根因。

常见问题

为什么 -run 写了测试名，仍然看到父测试？

因为框架可能需要先运行父测试来发现匹配的子测试。父测试出现不代表其他子测试都执行了。

-count=1 是不是只运行一次？

它的数值确实表示一次运行，同时也是显式关闭成功测试缓存的惯用写法。

什么时候应该使用 -count=20？

适合复现偶发失败、检查共享状态污染或验证修复后的重复稳定性；它不能替代对失败根因的修复。

参考：Go 官方 cmd/go 文档中的 Test packages、-run 和 -count 说明。