Go 子测试名字包含斜杠为什么筛选不到

Go 子测试名字里的斜杠会参与完整测试名的分段，筛选时不能只把它当成普通文本。构造 -run 参数时，先把顶层测试名和子测试名拼起来，再按斜杠逐段对应正则表达式。目标位于第三段时，只写到第二段通常会匹配错位置。

官方说明：https://go.dev/blog/subtests

测试参数文档：https://pkg.go.dev/cmd/go

触发信号：父测试执行了，目标子测试却没出现

考虑一个路由测试：用例名字直接写成 api/items。代码里只有一次 t.Run 调用，但它的完整名称包含顶层 TestRoute、api 和 items 三段。过滤参数若写成 TestRoute/items，items 就会拿去匹配 api 所在的位置，目标用例自然不出现。

下面是独立的原创教学示例，可保存为已有 Go 模块内的 route_test.go。它不访问网络，也不依赖外部服务；本文只说明规则，不把示例当作已执行的运行记录。

package routecase

import (
    "strings"
    "testing"
)

func TestRoute(t *testing.T) {
    cases := []struct {
        name string
        path string
        want string
    }{
        {"api/items", "/api/items", "items"},
        {"api/orders", "/api/orders", "orders"},
        {"web/home", "/web/home", "home"},
    }
    for _, tc := range cases {
        tc := tc // 为回调保留当前用例的数据。
        t.Run(tc.name, func(t *testing.T) {
            // 用简单路径提取说明测试选择，不涉及真实路由服务。
            got := strings.TrimPrefix(tc.path, "/")
            parts := strings.Split(got, "/")
            got = parts[len(parts)-1]
            if got != tc.want {
                t.Fatalf("got %q, want %q", got, tc.want)
            }
            t.Logf("selected case: %s", tc.name)
        })
    }
}

父测试负责创建子测试，因此父测试被执行和报告通过，不等于目标子测试被选中。排查时应先看具体叶子名称，而不是只看最后一行包级结果。

快速判断：把完整名称拆成匹配段

为避免一边看源码一边猜，可以把名称分成顶层段、分组段、叶子段，再把过滤式分成顶层正则、分组正则、叶子正则。它们按位置对应；这些名称只是本文解释用的标签，不是 Go 新增的 API。

这里的分段不等于源码里必须有三层 t.Run。斜杠既能来自嵌套测试的层级连接，也能来自传给 t.Run 的名称本身。重构前后的调用层数不同，显示名称仍可能相同。

处理步骤：修正筛选表达式

先确认顶层函数名，再精确填写目标名称的其余各段。下面命令假定当前目录就是示例所在包，使用适用于常见 POSIX shell 的单引号保护正则字符。

# 精确选择 api 分组里的 items，锚点限制每段的完整匹配
go test -v -count=1 -run='^TestRoute$/^api$/^items$' .
# 中间的空正则匹配任意分组，可选择不同分组中的 items
go test -v -count=1 -run='^TestRoute$//^items$' .
# 只约束到 api 分组，允许其下所有叶子用例
go test -v -count=1 -run='^TestRoute$/^api$' .

第二条命令中的连续两个斜杠保留一个空的中间正则，不是把路径压缩成一个斜杠。它适合已知叶子名、暂时不约束中间段的情况；若多个分组都有相同叶子名，它们都会进入候选范围。

不带锚点的正则通常可以匹配段中的一部分。因此排障时建议先对每段使用明确锚点，确认目标后再主动放宽。只在整个字符串两端加锚点，不能代替对中间段的约束。

给参数加引号解决的是 shell 如何传参，不能取消 Go 的分段规则。不要把“已经加了单引号”理解成整个 -run 值会成为一个不可拆分的字面量。业务名称里若还含有正则元字符，需要额外考虑各段内的字面匹配；这与斜杠分段是两层问题。

回滚路径：先恢复名称，再调整命令

如果为了修复筛选临时把 api/items 改成 api_items，CI 中原来按三段配置的参数就不再对应。显示名称、测试报告聚合键和旧命令都可能受影响。对于一次排障，优先保留现有名称，只修正过滤表达式；确需迁移名称时，再同步修改使用它的配置。

回滚操作可以只撤销测试用例名的改动，恢复旧的完整名称，然后使用逐段命令重新定位。无需修改被测业务逻辑，也无需通过跳过断言制造通过状态。若测试涉及真实资源，选择更宽的过滤范围前，应先确认父测试的初始化是否有副作用。

可以把排障所需信息分成两组：命名契约包括测试名称、筛选配置和报告标识；运行观察包括父测试、叶子测试和结果日志。筛选配置依据测试名称，报告标识也依赖名称；父测试容纳叶子测试，结果日志记录它们的运行情况。

确认信号：看叶子名称，不只看 PASS

在读者自己的环境里执行详细输出命令后，应寻找完整目标名 TestRoute/api/items，并结合该叶子的结果判断。只出现 TestRoute，或者只有包级通过信息，都不足以证明指定用例已执行。若条件分支根本没有调用相应 t.Run，正确的过滤式也不能创造这个子测试。

排查期间可以用 -count=1 避免复用测试结果缓存带来的困惑。它改变重复与缓存相关行为，不改变名称匹配规则。包路径也要明确：测试名正确而当前包不对，仍然找不到目标。

# 列出当前包的顶层测试，先核对函数名和包范围
go test -list='^TestRoute$' .
# 再执行目标叶子；-list 本身不会列出子测试
go test -v -count=1 -run='^TestRoute$/^api$/^items$' .

这些是供读者实际操作的命令，不是本文伪造的输出。真实结果还可能受构建标签、用例条件、初始化失败或前置跳过影响，应结合具体日志处理。

复盘项：约定稳定且可筛选的名称

团队可以把斜杠明确约定为分组分隔符，例如协议、资源、场景；如果名字本来只是一个无法拆解的业务标签，可以在生成用例名时采用不会引入层级的稳定写法。关键是让命名规则、CI 参数和报告查询保持一致，而不是事后不停叠加模糊正则。

为什么包含空格的名字看起来变了？测试框架会对名字做显示与匹配相关的规范化，其中空格会显示成下划线。构造过滤式时应结合实际完整名称，避免凭源码中的原始字符串猜测。

能否用 -list 枚举全部叶子？不能把它当作子测试目录；官方参数说明限定其只列顶层项目。子测试由运行中的父测试建立，需要结合详细运行信息观察。

为什么兄弟用例也执行了？检查是否只约束到父级，或使用了空中间段、未锚定的模糊表达式。先将每个名称段与正则段逐个对齐，再有意识地放宽范围。