Go test -run 匹配不到子测试名称时怎么写正则

很多人第一次筛选表驱动子测试时，会把完整名称直接写进 -run：go test -run 'TestOrder/Create/Region=East'。结果要么一个测试都没有，要么范围比预期更大。关键不在于 t.Run 不能匹配，而在于 Go 把测试名称按层级看待：父测试和每一层子测试名称用斜杠拼成标识，-run 也会按未加括号的斜杠拆成多段正则。

写 go test -run 时，先按父测试、子测试的层级拆分表达式，再决定每一段是否需要 ^ 和 $。要匹配所有父测试下名为 A=1 的子测试，可以从 go test -run '/A=1$' 开始；要锁定一条完整路径，则为每一层写清楚对应的正则。

如果你的子测试是通过`t.Run`嵌套定义的，`-run`参数的正则匹配规则默认是按「父测试名/子测试名」的完整路径做匹配，直接写子测试名的片段大概率匹配不到，调整正则命中完整层级路径就能解决。

为什么 -run 写了子测试名却匹配不到

先看一个最小的名称树：

func TestOrder(t *testing.T) {
    // 每个 t.Run 名称都会成为完整测试标识的一层。
    t.Run("Create", func(t *testing.T) {
        t.Run("Region=East", func(t *testing.T) {
            // 这里的完整名称是 TestOrder/Create/Region=East。
        })
    })
}

这里真正用于筛选的名称有三段：TestOrder、Create、Region=East。把它们看成一个普通字符串，容易忽略 -run 的层级规则；把它们看成三段，问题就清楚了。

官方文档还特别说明，父测试可能会被运行，即使它下面没有子测试最终匹配成功，因为测试框架需要进入父测试去寻找子测试。因此看到父测试出现在输出里，不等于所有子测试都被选中了。

把 -run 表达式按斜杠拆成对应层级

锁定上面那个最深的子测试，可以写成：

# 只匹配三层名称各自的完整值。
go test -run '^TestOrder$/^Create$/^Region=East$'

-run 会把这条表达式拆成三段：第一段匹配顶层测试，第二段匹配第一层子测试，第三段匹配第二层子测试。这里的 ^ 和 $ 让每一段从头到尾精确匹配，避免 CreateExtra 或 Region=EastBackup 意外命中。

如果只关心某个父测试下的第一层子测试，不必把更深层名称写出来：

# TestOrder 下名为 Create 的子测试及其内部子测试会进入筛选范围。
go test -run '^TestOrder$/^Create$'

反过来，如果所有顶层测试都可能有一个名为 A=1 的子测试，可以把第一段留空：

# 第一段为空，第二段匹配子测试名称。
go test -run '/^A=1$'

斜杠两侧不是字面路径，而是匹配层级的分隔符。若要匹配名称中任意位置的文本，正则可以不加锚点，例如 -run 'Order/Create'；但调试时更推荐先用精确表达式确认层级，再放宽范围。

特殊字符与空段怎么处理

子测试名经常来自表格字段，例如 A=1、region-east 或 case[slow]。等号和连字符通常可以直接写；方括号、圆括号、加号、点号等在正则中有特殊含义，需要按正则规则转义。比如名称真的包含方括号时，不要把 [slow] 当成普通文本：

# 子测试名称是 case[slow] 时，方括号要转义。
go test -run '^TestOrder$/^case\[slow\]$'

还有两个容易混淆的边界：

• go test -run 'TestOrder/Create/Region=East' 中的斜杠会分段；如果需要把斜杠当作名称字符，必须考虑正则表达式本身的转义和测试框架的分段规则，不能简单照搬文件路径写法。
• /A=1 的第一段是空表达式，表示不限制顶层名称；它不是“忽略一次斜杠”，而是明确保留一个层级位置。

用命令组合验证匹配范围

排查“匹配不到”时，不要一上来就增加更多通配符。先用 -list 看顶层测试是否存在，再逐层收紧：

# 先确认顶层测试名称；-list 不会运行测试。
go test -list '^TestOrder$'

# 再确认父测试与第一层子测试的组合。
go test -list '^TestOrder$/^Create$'

# 最后运行目标层级。
go test -run '^TestOrder$/^Create$/^Region=East$' -v

-list 只列出顶层测试，不能展示所有子测试，所以它适合确认第一段；子测试的实际范围仍要用 -run 观察。命令行中的表达式建议用单引号包住，避免 shell 先处理其中的特殊字符；这只是保护命令文本，不能替代正则转义。

常见问题

为什么 -run 'Create' 会命中多个测试？

因为每段正则默认是不锚定的，Create 可以匹配包含这段文字的名称。需要唯一名称时写成 ^Create$，并把它放在正确的层级位置。

为什么子测试没命中，但父测试仍然出现在输出中？

父测试需要先运行，测试框架才能创建并检查子测试，所以父测试出现在输出中只说明筛选路径经过了它，不代表所有子测试都通过筛选。

能不能把完整名称写成一条带斜杠的正则？

可以写完整的层级表达式，但未加括号的斜杠仍会被 -run 当作分隔符。实践中按名称层级逐段写，并为需要精确的段加锚点，最不容易误判。

记住一条排查顺序：先确认真实测试名称，再数清斜杠对应的层级，随后决定每段是否需要锚点，最后用 -list 和精确的 -run 组合确认范围。这样处理后，绝大多数“子测试名写对了却匹配不到”的问题，都能定位到名称拼接或正则边界，而不是测试框架失效。