Go test -run 正则匹配子测试名称时为什么一个都没运行

命令写成 go test -run 'TestCheckout/success' 却一个子测试都没有，通常不是 testing.T.Run 失效，而是把“完整名称”误当成了一个普通正则。Go 会把 -run 中未转义的斜杠拆成多段，每段分别匹配测试层级；只写子测试名时，工具其实拿它去匹配顶层测试函数，当然可能得到 [no tests to run]。

先看清 Go 实际拿什么名称匹配

假设测试代码如下，t.Run 的名字会和父测试名组成层级路径：

func TestCheckout(t *testing.T) {
	// 子测试名称决定 -run 路径中的下一段。
	t.Run("success", func(t *testing.T) {})
	t.Run("timeout", func(t *testing.T) {})
}

排查时先执行：

go test -v -run 'TestCheckout'
# -v 只用于展开测试树，先确认父测试和子测试的实际显示名称

你会看到类似 TestCheckout/success 和 TestCheckout/timeout。这一步的意义是确认父测试是否存在、子测试是否真的由 t.Run 创建，以及名称中的空格是否已经显示成下划线。

为什么只写子测试名会一个都不运行

-run 对测试使用的是“按层级分段的正则”。下面三种写法含义不同：

匹配子测试时，父测试仍可能先出现在日志里，因为 Go 需要运行父测试来发现它的子测试。看到 === RUN TestCheckout 不等于目标子测试已经命中，要继续看下一行是否出现 TestCheckout/success。

斜杠和空格会改变正则的层级

如果子测试名是 region/eu，显示名称会继续按斜杠分成层级。想匹配最后一段 eu，可写：

go test -v -run 'TestCheckout//eu'
# 中间的空段表示“这一层任意匹配”，最后一段才匹配 eu

这也是很多“看起来完整却匹配不到”的来源：TestCheckout/region/eu 会被解释为三段，而不是一个包含斜杠的普通子串。空格则按测试名称规则规范化，通常应根据 -v 输出使用下划线形式。正则中的 |、括号或 $ 也建议放进单引号，避免 shell 先改写命令。

用锚点和反向验证收紧筛选

默认正则不是自动全字匹配，因此 success 也可能命中 success_cached。需要单个用例时，按层级给每一段加 ^ 和 $：

go test -v -run '^TestCheckout$/^success$'
# 第一段锁定父测试，第二段锁定子测试；引号让 shell 原样传递正则

仍然没有输出时，按这张清单反查：父函数是否以 Test 开头并位于测试文件；子测试名是否由当前父测试创建；表达式里的斜杠数量是否与层级一致；是否把测试名写成了原始空格而非规范化名称。不要先加 -count=1，它只影响缓存重跑，不会修复名称没有命中的问题。

常见问题

为什么 -run 能看到父测试，却看不到子测试？

父测试命中后，工具只是进入父测试寻找子测试；如果后续分段没有命中，父测试可能被探测但目标子测试不会运行。

能不能用一个正则跨过父测试层级？

不能把子测试名当作独立全局名称。应保留父测试段；若只关心任意父测试下的某一级子测试，可以用开头空段，例如 -run '/^success$'。

为什么加了引号还是匹配不到？

引号只能防止 shell 改写，不能修正层级。继续检查父测试名、斜杠分段、名称规范化和正则锚点。