Go t.Run 名称含斜杠时 -run 正则如何匹配

我第一次把路由案例放进 t.Run 时，顺手把名称写成了 HTTP/GET。测试报告看起来很自然，但用 go test -run 筛选时，才发现这个斜杠并不是普通字符：它会把一个子测试名称继续切成路径段。

含斜杠的 t.Run 名称，会和顶层测试名一起按斜杠分段；-run 的每一段正则依次匹配对应名称段。要跳过一个中间段，用连续两个斜杠；要只命中完整路径，再给每段加 ^ 和 $。

斜杠会把 t.Run 名称变成可筛选的路径

t.Run 的名字会和父测试名组合成完整测试名。下面的三个案例虽然只调用了一层 Run，报告中仍然会出现三段路径：

func TestRoutes(t *testing.T) {
	// 中文说明：斜杠保留在报告名中，同时也成为 -run 的分隔点。
	for _, name := range []string{"HTTP/GET", "HTTP/POST", "TCP/GET"} {
		name := name // 中文说明：固定循环变量，避免闭包读取后续迭代值。
		t.Run(name, func(t *testing.T) {
			// 中文说明：真实项目中在这里放对应路由的断言。
		})
	}
}

可以把它们抽象成 TestRoutes / HTTP / GET、TestRoutes / HTTP / POST 和 TestRoutes / TCP / GET。这不是把 t.Run 自动改写成多层 Go 函数，而是测试框架在匹配和报告时把名称当成斜杠路径处理。

用 -run 的分段正则定位目标案例

先记住一个容易漏掉的细节：-run 不是把整条字符串交给一个正则。Go 文档规定，测试用的正则会按未被括号或字符类包住的斜杠拆分，每一段去匹配测试标识符的对应部分。因此，筛选上面的 HTTP/GET 可以写成：

# 中文说明：第一段匹配顶层测试，后两段匹配子测试名称的两个路径段。
go test -run='TestRoutes/HTTP/GET' -v

# 中文说明：空片段不限制中间路径，最后一段选出所有 GET 案例。
go test -run='TestRoutes//GET' -v

第一条只表达“前三段分别匹配 TestRoutes、HTTP、GET”。第二条的 // 不是多余的斜杠：它保留了一个空正则片段，所以可以命中 HTTP/GET 和 TCP/GET。如果名称本身是 America/New_York，同样可以用 TestTime//New_York 跳过洲或区域这一段。

默认不锚定，精确选择要主动写边界

-run 的正则默认是不锚定的。也就是说，HTTP 能匹配包含 HTTP 的名称片段；模式只写到第二段时，匹配父路径的后代也属于正常结果，因为父测试需要先运行，才能发现符合条件的子测试。

如果测试树中存在 HTTP/GET、HTTP/GET-JSON 等名称，想只选前者，可以把每一段写成完整匹配：

# 中文说明：^ 和 $ 约束每个路径段，避免 GET-JSON 等名称被一起选中。
go test -run='^TestRoutes$/^HTTP$/^GET$' -v

# 中文说明：-count=1 关闭缓存，便于调试筛选结果是否真的改变。
go test -count=1 -run='^TestRoutes$/^HTTP$/^GET$' -v

命令行 shell 的引号也很重要。单引号能让括号、美元符号和空格原样传给 Go；在 Windows shell 中则按对应 shell 的转义规则处理。若名称含空格，测试框架会把它规范成下划线，筛选式也应按规范化后的名称书写。

名称设计和排查命令怎么选

我的经验是：斜杠适合表达稳定层级，例如 协议/方法、地区/城市；如果业务数据里的斜杠只是普通文本，就改成 HTTP-GET 或 HTTP_GET，后续筛选更直观。不要试图用 [/] 把已经形成的路径重新拼回一个名称段，测试名本身仍会按斜杠切开。

排查筛选不生效时，先用 -v 看报告中的完整名称，再逐段减少正则范围；最后用锚点收紧。父测试出现在输出里不代表它的所有子测试都执行了，它可能只是为了发现匹配子测试而运行。这个判断能区分“筛选错了”和“框架正常执行父级探测逻辑”两类问题。

常见问题

为什么 -run='TestRoutes/HTTP' 会看到 GET 和 POST？

因为模式只限制到 HTTP 这一段，后续路径仍可作为它的后代被发现。要选叶子案例，继续写上 /GET，并按需要加锚点。

双斜杠是不是表示匹配一个字面量斜杠？

不是。它表示一个空的中间正则片段，用来跳过一层名称段；测试名称里的斜杠本身仍是分隔符。

怎样确认 Go 实际看到的测试名？

使用 go test -run='TestRoutes' -v 查看 === RUN 行，再根据输出逐段组合筛选式；需要排除缓存时加 -count=1。