Go t.Run 怎样设计稳定的子测试名称

Go 的子测试名称最好用固定、唯一、可读的语义标识，例如 valid/plain_ascii，把变化的输入留在测试数据里。需要用命令行稳定地挑出一个用例时，让名字各层对应 -run 的一段正则，并用 ^ 和 $ 限定整段。

假设一个项目把失败用例的重跑命令写进 CI 记录，我会优先保证“新增一条数据后，旧命令仍指向原用例”。这里是一个假设的维护场景，我的取舍不代表已经在生产项目取得某种收益；下文示例也没有在本地执行。

把测试名当成 CI 的筛选入口

名称既供人读，也可能成为脚本参数。case_3 很省事，但在前面插入数据后，原第 3 条可能变了。时间戳、随机数、临时目录和生成顺序，都不适合作为长期引用的名称。

我会把名字看作测试的接口：规则不变时保留名字，行为边界改变时再考虑更名。稳定不等于永远不改，而是不让无关的数据变化自动改变标识。临时探索可以用序号；长期回归和 CI 定点重跑更值得维护语义标识。

约定字符与名称层级

t.Run 的名称参数参与完整测试名的组成，父层与子层用斜杠连接。testing 会处理空白和不可打印字符，不能把原始字符串与最终显示名称总是视为相同。我建议本例的分组、叶子名只使用小写 ASCII 字母、数字、下划线。这是团队约定，不是 Go 的限制。

TestSlug/valid/plain_ascii 分别表示顶层 TestSlug、分组 valid、叶子 plain_ascii。输入 hello-world 留在字段里即可，不必拼进名称。中文可作为名称，但也要考虑团队命令行输入与检索习惯。

比较三种命名方案

对我来说，语义命名的价值在于分开“检验什么”与“使用哪个输入”。has_space 可以表示含空格的拒绝边界；有多个不同空格场景时，使用 leading_space、middle_space 等不同名字，不让运行库替我们编号。

用分组代码和正则选择用例

将下面示例存为已有模块中的 slug_test.go。acceptable 只是便于展示的 ASCII 标识规则，真实项目应替换成业务函数。本例没有并行测试，不扩展闭包或调度问题。

package slug

import "testing"

// acceptable 仅演示一个简单的 ASCII 标识规则。
func acceptable(s string) bool {
    if s == "" {
        return false
    }
    for _, r := range s {
        if !((r >= 'a' && r = '0' && r 

# 在当前包选择 valid 组的 plain_ascii 用例。
go test -count=1 -v -run '^TestSlug$/^valid$/^plain_ascii$' .

# 选择 valid 分组，不限制其后叶子。
go test -count=1 -v -run '^TestSlug$/^valid$' .

# 空的第二段匹配任意分组，第三段限定叶子。
go test -count=1 -v -run '^TestSlug$//^has_space$' .

三个命令的预期选择对象分别是 TestSlug/valid/plain_ascii、valid 的两个用例和 TestSlug/invalid/has_space。这是根据代码结构推导的目标，不是已运行的输出。-count=1 避免复用测试结果缓存，. 指当前包，不会自动选择所有子包。

处理重复名与父测试执行边界

同一父测试下重复使用名称时，testing 会追加序号区分；空名称也会获得编号。它能保证一次运行里的唯一性，却不能保证重排之后仍指向同一业务场景。空白转成下划线也可能造成显示名称碰撞，因此不要把 has space 和 has_space 当作可靠的不同名字。

斜杠影响过滤层级。即使一次 t.Run("valid/plain_ascii", ...) 只创建一个子测试，名称里的斜杠仍参与 -run 分段匹配。我更倾向于显式嵌套，让代码结构与名称层级一致。如果输入是路径 assets/icons/a.png，可把名字写成 nested_path，把路径留在数据中。

-run 是正则，不是字面字符串。点、括号、方括号等需要按正则规则处理。shell 引号只阻止 shell 解释参数，不能把正则变成字面匹配。段内不加锚点会允许子串匹配，例如 valid 也可能匹配 invalid。限制字符集合可以降低维护成本，但不能代替正确编写过滤规则。

为了发现匹配的子测试，父测试函数仍需运行。父层准备逻辑不会因为叶子过滤自动消失。名称规范控制的是选择，不保证资源隔离，也不保证昂贵父层准备被跳过。

保存命名约定与常见问题

我的选择是顶层对应能力、分组对应少量稳定类别、叶子对应唯一场景。一层表驱动测试够用时，直接 TestSlug/plain_ascii 就很好；每增加一层，长期过滤命令也多维护一段。这套结构更适合长期回归，不必让所有临时测试都变复杂。

• 新增用例保留旧标识，不按插入位置改名。
• 同层名称唯一，不依赖自动编号。
• 更名时同步更新 CI 参数和定位说明。
• 保存命令针对的包和必要父层条件。

名字必须是合法的 Go 标识符吗？

不是，参数是字符串。ASCII 约定只是降低输入与正则成本，并非语言规定。

为什么 -list 没列出全部子测试？

go test -list 列出匹配的顶层测试等入口，不运行测试，不展开需要执行父函数才能发现的子测试。用 -v 观察子测试名时，也要知道那意味着真正执行测试，而不是静态列表。

不同分组可以有同名叶子吗？

可以，完整名称不同。但仅限定叶子可能选择多个分组，长期重跑命令应带上必要父层条件。

官方资料：testing 文档 https://pkg.go.dev/testing；测试参数 https://pkg.go.dev/cmd/go#hdr-Testing_flags；名称匹配实现 https://go.dev/src/testing/match.go。测试名称是一项维护约定，明确语义和层级比堆入完整输入更容易长期复用。