Go test 怎样只执行指定子测试

Go 的表格驱动测试经常把多个场景放进同一个 `TestXxx` 函数。需要单独重跑一个场景时，不必临时删掉其它用例：只要给 `t.Run` 使用稳定名称，再用 `go test -run` 按测试名路径筛选即可。

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

最常用的写法是 `go test -run 'TestUser/Create' ./...`。它先匹配顶层测试 `TestUser`，再匹配名为 `Create` 的子测试；如果不希望命中相似名称，可以写成 `^TestUser$/^Create$`。

• -run 的参数是正则表达式，默认不是整段精确匹配。
• 子测试的层级用斜杠连接，命令中的斜杠也表示逐段匹配。
• 筛选只适合快速回归，提交前仍应执行完整测试。

先让测试名称形成稳定层级

t.Run 的第一个参数会成为子测试名称。下面的例子把用户模块的创建、读取和删除拆成三个可定位的场景。名称应描述业务动作，不要把数组下标作为唯一标识，否则测试顺序变化后命令也会失效。

package user_test

import (
    "testing"
)

func TestUser(t *testing.T) {
    cases := []struct {
        name string
        want string
    }{
        {name: "Create", want: "created"},
        {name: "Read", want: "loaded"},
        {name: "Delete", want: "deleted"},
    }

    for _, tc := range cases {
        tc := tc // 固定当前循环值，让子测试使用自己的场景数据。
        t.Run(tc.name, func(t *testing.T) {
            got := fakeUserAction(tc.name) // 示例动作代表真实业务调用。
            if got != tc.want {
                t.Fatalf("action %s = %q, want %q", tc.name, got, tc.want)
            }
        })
    }
}

func fakeUserAction(name string) string {
    switch name {
    case "Create":
        return "created"
    case "Read":
        return "loaded"
    case "Delete":
        return "deleted"
    default:
        return "unknown"
    }
}

这个函数运行时会出现类似 TestUser/Create、TestUser/Read 的完整名称。正是这条名称路径，让命令行可以定位到一个子测试，而不必给每个场景额外创建顶层函数。

用 -run 只执行一个子测试

对上面的测试，最短的筛选命令是：

# 只运行 TestUser 下名称包含 Create 的子测试。
go test -run 'TestUser/Create' ./...

在模块根目录执行时，./... 表示当前模块下的所有包；如果只想运行当前包，可以把它换成 .。命令中的单引号让 shell 不提前解释正则字符，在 Bash、zsh 和 PowerShell 中都比较直观。

如果项目里同时存在 TestUser/CreateBackup，上面的表达式也可能命中它，因为 -run 默认使用未锚定正则。要只执行完整的两个名称段，可以加上锚点：

# ^ 和 $ 分别限定顶层测试段与子测试段的完整边界。
go test -run '^TestUser$/^Create$' ./...

也可以只限定顶层测试、让子测试保留一组可选动作：

# 只看 TestUser 下的 Create 或 Delete 两个场景。
go test -run '^TestUser$/(Create|Delete)$' ./...

理解 -run 的斜杠和正则边界

官方 testing 文档把子测试名称看成由斜杠分隔的多个部分。筛选表达式也按斜杠分段：第一段对应顶层测试，第二段对应子测试，继续嵌套时再增加段。单独写一个动作名称时，可以让第一段为空，从所有顶层测试中寻找该子测试。

# 在所有顶层测试中寻找名称以 Create 结尾的直接子测试。
go test -run '/^Create$' ./...

测试名本身也可能包含空格、斜杠或正则特殊字符。测试框架会对名称做必要的唯一化处理，但命令行筛选仍应优先使用稳定、简单的英文动作名。如果业务名称必须包含特殊字符，就把它当作正则输入处理，必要时转义，或者在测试代码里增加一个更适合命令行定位的外层名称。

把筛选命令用于快速回归

开发阶段可以配合详细输出确认实际命中的完整路径：

# -v 打印测试和子测试名称，便于确认筛选范围。
go test -v -run '^TestUser$/^Create$' ./...

如果目标测试依赖昂贵的共享初始化，父测试函数中位于 t.Run 之前的代码仍会执行。筛选命令减少的是子测试主体，不等于跳过所有准备工作；要缩短反馈时间，应把与具体场景无关的初始化放到更小的作用域，并保证清理逻辑仍由 t.Cleanup 或明确的 defer 管理。

命令可以作为本地调试入口，但不要把它误当成 CI 的完整门禁。一个实用的分工是：修改某个场景时用 -run 快速回归，提交前运行不带 -run 的完整测试，夜间任务再补充竞态检测或更长流程。

常见问题

为什么写了 Create 还是运行了多个测试？

因为 -run 使用未锚定正则，Create 会匹配包含这段文字的名称。先用 -v 查看完整名称，再用 ^Create$ 或分段表达式收紧范围。

能不能只写子测试名，不写顶层测试名？

可以。使用 go test -run '/^Create$' . 会让第一段为空，从多个顶层测试中查找名为 Create 的子测试；如果项目很大，带上顶层名称通常更容易读懂，也更不容易误命中。

指定子测试后，父测试代码还会执行吗？

可能会执行。测试框架需要进入父测试才能发现它动态创建的子测试，因此父测试中位于 t.Run 前面的准备代码不应被当作“不会运行”。把场景准备放入对应子测试，可以让筛选真正减少无关工作。

筛选命令能代替完整回归吗？

不能。它适合定位、调试和快速反馈；完整测试仍要覆盖其它子测试、包和共享初始化路径。可以把精确的 -run 命令留在本地或故障复现脚本里，CI 继续执行完整测试。

记住三点就够了：先用 t.Run 取一个稳定名称，再用斜杠表达测试层级，最后用 ^ 和 $ 处理精确边界。这样既能快速重跑单个场景，也不会因为名称包含关系把其它测试一起带上。