Go test -run 为什么匹配不到想运行的测试

使用 go test -run 却没有跑到想看的测试，通常不是 Go 忽略了测试，而是筛选表达式没有命中测试的真实名称。-run 接收的是不锚定正则；遇到 t.Run 时，完整名称还会按斜杠分段匹配。先把“函数名、子测试路径、命令行表达式”对齐，问题就能快速定位。

-run 不是完整相等匹配，先看顶层测试名

Go 的测试筛选规则把 -run 当作正则表达式处理，而且默认是不锚定的。比如测试函数是 TestLogin 和 TestLoginExpired，执行 go test -run Login 时，两者都可能命中；只有加入起止锚点，才是在表达“整个名称必须相等”。

如果你想先确认包里有哪些顶层测试，可以用 -list 输出名称。命令只用于查看测试标识，不会替代真正的筛选命令：

# 先列出当前包中的测试名称，确认 -run 应该匹配什么
go test -list .

# 包含匹配：命中名称中含 Login 的顶层测试
go test -run 'Login'

# 完整匹配：只命中名为 TestLogin 的顶层测试
go test -run '^TestLogin$'

这里的关键是先区分“包含一个片段”和“完整匹配整个名称”。如果表达式本身带 ^、$ 或括号，建议用单引号包住，避免 shell 先解释特殊字符。

子测试要按完整路径写，斜杠不是普通字符

t.Run 会给测试建立层级名称。假设代码中有 TestCheckout，下面又创建了“国内”和“海外”两组子测试，那么实际筛选时要把父测试和子测试写成路径，而不是把整段当成一个普通字符串。

package checkout_test

import "testing"

func TestCheckout(t *testing.T) {
	// 用 t.Run 建立父测试和子测试的名称层级，便于按场景筛选。
	t.Run("国内", func(t *testing.T) {
		// 这个子测试的完整路径包含父测试和“国内”。
		t.Run("空购物车", func(t *testing.T) {
			// 示例只表达名称层级，实际断言应放在这里。
		})
	})
	t.Run("海外", func(t *testing.T) {
		// 海外场景下继续按“有效卡片”划分子测试。
		t.Run("有效卡片", func(t *testing.T) {})
	})
}

对应的筛选可以写成：

# 只筛选 TestCheckout 下名称含“国内”的分支
go test -run 'TestCheckout/国内'

# 继续精确到“国内/空购物车”这一层级
go test -run 'TestCheckout/国内/空购物车'

# 只按子测试段匹配空购物车，不限定父测试名称
go test -run '/空购物车'

Go 会对测试名称和传入的匹配表达式做同样的名称清洗，例如空格会显示为下划线。因此代码里写的是 empty cart 时，命令通常应按 empty_cart 思考；中文名称也要以实际输出为准。父测试没命中时，后面的子测试表达式再准确也不会生效。

把“命令没命中”拆成四个边界检查

还有一个容易混淆的边界：-run 是 Go 工具负责的筛选参数，而 -args 之后的内容会原样传给测试二进制。把测试自定义参数放到 -args 后面，不会让它参与 -run 匹配；包路径也应放在 -args 之前。

常见问题

为什么写 -run TestLogin 还是会匹配多个测试？

因为默认是不锚定正则，TestLoginExpired 也包含这段文本。改成 ^TestLogin$ 才是完整名称匹配。

为什么只写子测试名没有结果？

嵌套测试通常要先通过父测试段；优先使用完整路径，例如 TestCheckout/国内/空购物车，再逐段缩短定位。

为什么命令里的空格和代码中的空格不一致？

测试名称会经过清洗，空格可能变成下划线。先用 go test -list . 或详细输出确认实际名称，再复制名称片段组成表达式。

排查 go test -run 时，顺序可以固定为：先列出名称，再判断是否需要锚点，接着按斜杠补齐父子路径，最后处理名称清洗和 shell 引号。这样能把“没有运行”还原成一个具体的匹配边界问题。