Go test -run 为什么指定后没有执行

go test -run 指定后没有执行目标用例，通常是把文件名当成了测试名称、选错了包，或者子测试路径没有匹配上。先明确包目录，再用单引号包住带首尾锚点的测试名；若显示 (cached)，则是复用了成功结果，不等于正则没有匹配。

Go 命令官方文档：https://pkg.go.dev/cmd/go#hdr-Testing_flags

testing 官方文档：https://pkg.go.dev/testing

先把包路径和测试名称分开

# 在模块目录中，明确测试包与顶层测试名，并要求本次实际执行
go test ./internal/report -run '^TestFormatLabel$' -count=1 -v

这里的 ./internal/report 是示例包目录，使用时替换成自己的包。-run 只在已选中的包里筛选名称，不负责搜索整个仓库。当前目录的包用 .，模块下多个包可用 ./...；后者可能在多个包中选中同名测试。

命令中的包范围、名称模式、缓存策略和详细日志分别由包参数、-run、-count=1、-v 表达。这四个对象属于不同职责，修改其中一个不能代替另一个。-run 也不会让未被当前构建条件纳入的文件突然出现。

文件名匹配为什么会落空

例如文件叫 label_test.go，其中声明 TestFormatLabel。写 -run label_test.go 并不是“运行这个文件”，它仍然把这段字符当正则去匹配测试名称。测试函数名称区分大小写，大小写和拼写都要与声明一致。

# 只列出当前包中可发现的顶层名称，不执行测试函数
go test . -list '^TestFormat'
# 正则默认不是整串匹配；加锚点表达准确的顶层名称
go test . -run '^TestFormatLabel$' -count=1 -v

-list 不展开动态子测试，列不到子测试名不能据此认定它不存在。普通测试应位于 _test.go 文件中，并采用合法的测试签名；文件还要符合当前平台、构建标签及包范围。用显式文件列表调用 go test 是另一种包构造方式，排查单个用例时通常先用包目录更清楚。

按父测试与子测试逐段匹配

若父函数是 TestFormatLabel，内部调用 t.Run("compact", ...)，完整名称中会出现 TestFormatLabel/compact。不能只写 -run '^compact$' 就期待搜索所有父测试的子项；模式的第一段仍对应顶层名称。

# 指定父测试和直接子测试，每一层分别加锚点
go test . -run '^TestFormatLabel$/^compact$' -count=1 -v

Go 将未被方括号包住的斜杠作为模式分段界限，各段对应测试名的层级。为查找子测试，匹配到的父测试函数仍须执行，所以父函数中的公共准备逻辑也可能执行；这不是只调用某个内部回调的机制。即使没有匹配的子项，某些匹配父项仍会被运行并报告。

对子测试命名应优先用稳定、简短的名称。若名称自身含斜杠，完整名称也会多出层级，不能把视觉上一个 case 名简单视为单段。空格等名称规范化也可能影响实际显示的名称；以详细输出中使用的完整名称为准。

用一份小测试对照选择范围

下面是原创的独立示例，可保存为已有 Go 包中的 label_test.go。如果包名不是 report，请同步修改包声明。它不依赖额外业务函数，便于把“名称是否选中”和“业务是否成功”分开观察。

package report

import (
    "strings"
    "testing"
)

// 用独立的小函数承载断言，避免示例依赖真实业务或外部服务。
func formatLabel(value string) string {
    return strings.TrimSpace(value)
}

func TestFormatLabel(t *testing.T) {
    // 子测试名称就是选择表达式的下一层，不是文件名称。
    t.Run("compact", func(t *testing.T) {
        got := formatLabel("  note  ")
        if got != "note" {
            t.Fatalf("标签不符：得到 %q，期望 %q", got, "note")
        }
    })
    t.Run("verbose", func(t *testing.T) {
        // 第二个子项用于对照筛选范围，不代表执行顺序约束。
        got := formatLabel("  memo ")
        if got != "memo" {
            t.Fatalf("标签不符：得到 %q，期望 %q", got, "memo")
        }
    })
}

按上节的父子表达式执行时，预期选择 compact 子测试，不选择 verbose 子测试；父函数仍参与运行。这里说明的是示例的预期行为，不是本机实测日志。若把模式改为 '^TestFormatLabel$'，只限制顶层名称，未指定子层过滤，因此两个子项都可运行。

区分缓存、跳过与没有匹配

测试结果缓存主要在包列表模式生效，go test 不带包参数的本地目录模式与 go test . 不宜混为一谈。-count=1 是要求重新执行测试的常用写法，不需要为了一个用例删除整个构建缓存。测试本来就应该用断言表达结果，不要只靠成功测试中默认隐藏的日志判断是否执行。

还有一类问题是 TestMain 没有调用 m.Run()，或者父测试在创建子项前提前返回或跳过。此时改正正则不足以修复控制逻辑。-run 也不是基准测试的选择开关，基准名称应使用 -bench；没有匹配到测试并不自动意味着命令失败。

把准确命令留给本地和 CI

本地复现命令最好同时记录包目录和完整名称，并在排障期间保留 -count=1 -v。在 zsh、Bash 等 shell 中，单引号能避免 $ 和正则字符被 shell 解释。Windows cmd 的引号习惯不同，不能把单引号原样当成通用跨平台语法；IDE 配置也应确认最终实际传给 Go 的参数。

为什么只写名称片段有时选多了？ 因为正则默认不是整串匹配；需要准确名称时分别为每个层级加首尾锚点。

-list 能证明子测试存在吗？ 它只列顶层名称。子测试由父函数创建，排查需要阅读 t.Run 声明或在受控环境查看完整名称。

CI 返回成功能证明目标用例执行过吗？ 不能单看退出码。应结合测试报告中的目标名称和状态判断，未匹配与跳过都不能算目标断言通过。

把排查顺序固定为“包范围、测试发现、名称层级、缓存与跳过条件”，可以避免反复扩大正则却仍然选不中用例。这里调整的是命令使用方式，不是引入了新的测试语义或版本迁移要求。