Go test -run 精确匹配带斜杠的嵌套子测试

Go 的 -run 不是把完整测试名当成一段普通字符串来查找。遇到嵌套子测试时，它会把表达式和测试名都按斜杠分成多段，再逐段做正则匹配。想只运行一个目标，关键是给每一段加锚点，并用 shell 引号保护表达式。

为什么 -run 要按斜杠拆成名称段

假设测试代码使用了三层名称：

func TestOrder(t *testing.T) {
    // 用分组和用例名称构造稳定的测试层级。
    t.Run("region/eu", func(t *testing.T) {
        t.Run("case_1", func(t *testing.T) {
            // 这里放订单校验；示例只展示筛选所需的命名结构。
        })
    })
}

测试框架会得到一条类似 TestOrder/region/eu/case_1 的完整名称。这里的每个斜杠都代表一层匹配边界，所以 -run=TestOrder/region 表示顶层段匹配 TestOrder，下一段匹配 region；它不是对整条字符串执行一次普通的 contains。

这个规则也解释了一个常见误区：只写 -run TestOrder 往往会保留 TestOrder 下的多个子测试。它适合先确认顶层范围，不适合表达“只跑某一个 case”。

用分段锚点精确定位一个嵌套子测试

把上面的分组名简化为 region_eu 后，最稳的写法是：

# 每个斜杠段对应一层名称，^ 和 $ 防止同前缀用例混入。
go test -run='^TestOrder$/^region_eu$/^case_1$' ./...

三个锚点分别约束三层。若只想筛选某个地区下的所有用例，可以保留前两段，并让第三段留空或省略；若要筛选所有顶层测试里的 case_1，则可以从斜杠开始写后续段。实际选择哪种写法，取决于你要锁定测试树的哪一层。

锚点、特殊字符与 shell 引号要一起处理

-run 接收的是正则表达式。测试名中的空格会被清洗为下划线，其他非打印字符也会按 testing 包的规则处理，因此不要直接照抄显示前的原始名称。像 A=1、括号或方括号这类字符，既可能有测试命名含义，也可能有正则含义；需要匹配字面量时，应在正则里转义。

# 名称含等号时仍按完整段匹配；单引号避免 shell 先解释正则字符。
go test -run='^TestMatrix$/^A=1$' ./...

# 名称含括号时，把括号当普通字符而不是捕获分组。
go test -run='^TestMatrix$/^case\(slow\)$' ./...

单引号保护的是 shell 层，不会替你完成正则转义。排查时先用 go test -list 观察测试树，再用 -v 对照实际匹配到的名称；如果测试依赖环境或生成文件导致结果看起来像缓存，才考虑加 -count=1 强制重新执行。

常见问题

为什么表达式写了一个斜杠却没有匹配到用例

通常是名称层级不一致，或者实际名称经过了空格清洗。先用 go test -list='TestOrder' 查看完整名称，再按显示出的斜杠层级重写表达式。

为什么不加 ^ 和 $ 会多跑测试

未锚定的正则是非锚定匹配，case_1 可能命中 case_10 或其他包含相同片段的名称。需要单个用例时，优先把每一段都锚定。

如何只筛选所有父测试下同名的子测试

把父级段留空，从斜杠开始写子测试段，例如 -run='/^case_1$'。这会扩大顶层范围，使用前要确认同名用例是否会被一起选中。