go test -run 正则匹配不到子测试的处理方案

go test -run 匹配不到子测试时，优先检查的不是测试框架，而是“测试名路径”和正则的分段方式。Go 会把测试名中的未转义斜杠当成层级分隔符：-run=TestImport/HTTP 的第一段匹配父测试，第二段匹配由 t.Run 创建的子测试。表达式写成完整名称、把斜杠放进字符类，或忽略了子测试实际名称，都会得到“没有命中”的结果。

官方地址：https://go.dev/

先用 go test -list '^TestImport$' 确认顶层测试存在，再用 go test -run '^TestImport$/^HTTP$' -v 精确匹配父子两级。若父测试运行但没有子测试输出，继续检查 t.Run 是否真的被执行。

先看测试名路径，再写 -run 表达式

子测试并不是一个独立的 Go 函数入口，它由父测试在运行时调用 t.Run 创建。下面的测试会形成三条可匹配的名称：顶层的 TestImport，以及 TestImport/HTTP 和 TestImport/Timeout。

package importtest

import "testing"

func TestImport(t *testing.T) {
	// 子测试名称会拼接到父测试名后，形成可供 -run 匹配的路径。
	t.Run("HTTP", func(t *testing.T) {
		t.Log("检查 HTTP 导入")
	})
	t.Run("Timeout", func(t *testing.T) {
		t.Log("检查超时导入")
	})
}

因此，go test -run '^TestImport$' 只筛选父测试；go test -run '^TestImport$/^HTTP$' 才是在父级和子级各匹配一次。不要把完整路径当作一个不含分隔语义的普通字符串，也不要在表达式两端省略边界后再根据模糊命中猜结果。

斜杠决定正则对应哪一级

-run 的值会按未被字符类包住的斜杠拆成一组正则。第一段用于顶层测试，第二段用于子测试，后续段继续对应更深层的 t.Run。每一段都使用正则语义，而不是简单的字符串相等。

# 第一段锁定父测试，第二段锁定子测试。
go test -run '^TestImport$/^HTTP$' -v

# 只要求父测试名以 TestImport 开头，子测试名包含 HTTP。
go test -run '^TestImport/^.*HTTP.*$' -v

# 斜杠若是名称本身的一部分，需要放进字符类，避免被当成层级分隔符。
go test -run '^TestPath/[/]raw$' -v

最后一条命令展示的是正则解析边界：未转义的 / 会分段，放入字符类 [/] 后才表示名称中的斜杠。实际工程中更推荐让 t.Run 名称使用稳定、短小且不包含斜杠的标识，这样 CI 命令更容易读懂。

特殊字符和大小写会让“看起来一样”的表达式失效

测试名来自字符串，正则却有自己的元字符规则。比如子测试名是 HTTP.v2 时，表达式中的点号会匹配任意字符；子测试名包含括号、加号或问号时，也不能直接把它们当作普通文本。大小写同样参与匹配，HTTP 不会自动命中 http。

func TestProtocol(t *testing.T) {
	// 名称中的点号是字面字符，命令行匹配时应使用 regexp.QuoteMeta。
	name := "HTTP.v2"
	t.Run(name, func(t *testing.T) {
		t.Log("运行协议子测试")
	})
}

# 点号用反斜杠转义，避免把任意字符误当成分隔点。
go test -run '^TestProtocol$/^HTTP\.v2$' -v

# 固定名称时，单引号可以让反斜杠原样交给 go test。
go test -run '^TestProtocol$/^HTTP\.v2$' -v

命令行脚本还多一层 Shell 转义，反斜杠既可能被 Shell 处理，也可能被正则解释。固定命令可以直接写单引号；动态拼接时应让生成逻辑负责转义，不要把用户输入原样拼到 -run 中。

用 -list 和 -v 分开确认“存在”和“执行”

排查时不要一上来反复修改正则。-list 只列出顶层测试、基准测试、模糊测试或示例，不会列出子测试；它适合确认父测试是否存在。确认父测试后，再用 -v 观察它是否创建了目标子测试。

# 先确认顶层 TestImport 是否存在，表达式两端加边界避免误命中。
go test -list '^TestImport$' ./...

# 再运行父子两级，并输出测试开始与结束信息。
go test -run '^TestImport$/^HTTP$' -v ./...

# 只验证父级是否能进入，不要求某个子级命中。
go test -run '^TestImport$' -v ./...

三种结果含义不同：-list 没有输出，说明顶层名称、包路径或构建条件就不对；父测试在 -v 中出现但没有目标子测试，说明父函数没有创建该名称或在创建前提前返回；父子都出现但失败，则已经不是匹配问题，而是测试逻辑本身失败。

父测试必须真的创建子测试

即使命令写对了，子测试也可能因为数据表为空、过滤条件不满足、提前返回或构建分支不同而没有被注册。-run=X/Y 会先运行可能匹配 X 的父测试，让它有机会寻找子测试；它不会凭空创建不存在的子测试。

func TestCache(t *testing.T) {
	cases := map[string]string{
		"Hit":  "cached",
		"Miss": "origin",
	}

	for name, want := range cases {
		name, want := name, want
		// 只有进入循环并调用 t.Run，子测试路径才会出现。
		t.Run("Redis/"+name, func(t *testing.T) {
			t.Logf("期望来源：%s", want)
		})
	}
}

上例的真实路径是 TestCache/Redis/Hit。要命中它，应写成 -run '^TestCache$/^Redis$/^Hit$'。如果 cases 在某个环境为空，父测试仍可能启动，但第三段没有任何子测试报告，这时需要检查输入数据和构建标签，而不是继续改正则。

把本地排查命令沉淀成稳定的 CI 选择

持续集成里建议优先使用带 ^ 和 $ 的边界表达式，并把命令旁边的测试路径写进注释。这样测试重命名时，失败会更明确；如果只写 Import 或 HTTP 这类片段，新增测试可能悄悄改变执行集合。

结论

go test -run 匹配不到子测试，通常按下面顺序就能定位：先用 -list 确认顶层测试存在，再用 -v 观察父测试是否进入；然后把表达式按未转义斜杠拆成和测试层级一致的段，最后检查特殊字符、大小写、提前返回和动态数据。记住，-run=X/Y 中的父测试是为了寻找子测试而运行，命令不会替你创建缺失的子测试。

相关问题

为什么 -run TestImport/HTTP 有时比精确写法多跑测试？ 因为两段都是正则，未加边界时可能匹配更长的父名或子名。需要单个测试时使用 ^ 和 $。

go test -list 为什么看不到子测试？ 官方行为是只列出顶层测试，子测试要由父测试实际运行后才会创建，因此应配合 -v 观察。

子测试名称里能不能使用斜杠？ 可以，但斜杠默认表示层级。若要按字面匹配，应把它放进字符类或使用等价的转义写法；更稳妥的工程约定是避免把斜杠放进动态名称。