Go testing.T.Name 怎样生成嵌套子测试标识

在表格驱动测试里，真正需要定位的往往不是某个测试函数，而是某个测试函数下面的具体数据行。testing.T.Name 会返回当前运行中的测试或子测试名称；如果测试通过多个 t.Run 嵌套，返回值会包含完整层级。它适合写入日志、错误信息和测试诊断上下文。

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

先记住一个结论：t.Name() 读取的是 testing 框架已经生成的当前名称，不需要手工把父测试名拼到子测试名上。相同的兄弟子测试名称还会由框架追加序号，以保证返回值唯一。

理解 Name 返回的标识范围

Name 的返回值不是最近一次 Run 的参数，而是当前测试树中的完整路径。普通测试可以返回类似 TestPricing，嵌套子测试则会把父测试和各层子测试连接起来。

Go 官方文档将它定义为当前运行中的测试或基准测试名称，并说明嵌套子测试会被包含在名称中；如果两个兄弟子测试同名，框架会自动增加后缀来保证结果唯一。这个语义决定了它更像测试报告里的路径，而不是业务对象的编号。

用 Run 组织嵌套名称

把测试数据拆成有含义的层级，名称本身就能帮助定位失败项。下面的代码让外层表示地区，内层表示具体场景；在最内层读取到的名称包含两层上下文。

package pricing_test

import (
	"testing"
)

func TestPricing(t *testing.T) {
	regions := []struct {
		name  string
		cases []string
	}{
		{name: "region=cn", cases: []string{"case=tax", "case=rounding"}},
		{name: "region=us", cases: []string{"case=tax"}},
	}

	for _, region := range regions {
		region := region // 固定本轮循环变量，避免闭包读取后续数据
		t.Run(region.name, func(t *testing.T) {
			for _, caseName := range region.cases {
				caseName := caseName // 让每个子测试保留自己的名称
				t.Run(caseName, func(t *testing.T) {
					t.Logf("当前测试标识=%s", t.Name()) // 记录完整父子路径
				})
			}
		})
	}
}

例如最内层可能得到 TestPricing/region=cn/case=tax。名称中的斜杠来自测试树结构，不是业务字符串的拼接结果；外层测试改名时，下面所有子测试的完整名称也会随之变化。

重复兄弟名称为什么会出现序号

测试数据有时会出现两个相同标签，例如两个输入都叫 case=default。如果框架原样返回两个相同名字，测试报告和 -run 筛选就难以区分。testing 会在重复的兄弟名称后追加序号，保证名称可区分。

func TestDuplicateCases(t *testing.T) {
	for range 2 {
		t.Run("case=default", func(t *testing.T) {
			name := t.Name() // 读取框架最终生成的名称，不自行猜序号
			t.Log("测试名称：", name)
		})
	}
}

这里的重点是“读取最终值”。不要在业务代码中假设一定是某个固定数字，也不要在名称外部再维护一套序号规则。若要让报告更容易阅读，优先让测试数据提供本身不同的名称；自动后缀是重复输入时的兜底机制。

把名称接入日志与错误信息

测试辅助函数通常不知道自己服务的是哪一行数据，但它可以接收 *testing.T 并读取当前名称。这样错误信息只保留一处名称来源，避免调用方和辅助函数重复拼接。

func assertPositive(t *testing.T, value int) {
	t.Helper() // 把失败位置指向调用方，而不是这个辅助函数内部
	if value 

当测试命令使用详细输出时，t.Log 和 t.Logf 会把信息放到当前测试上下文中。辅助函数可以把 t.Name() 放入自定义字段或错误文本，但不要把父名称再手动拼一次，否则名称层级变更后很容易出现重复前缀。

名称和 -run 筛选怎样配合

go test -run 使用测试名称路径来筛选测试，因此嵌套名称很适合在排障时缩小范围。比如有一条名称为 TestPricing/region=cn/case=tax，可以按父级或更具体的片段选择它。

# 只筛选 pricing 测试树中的中国地区子测试
go test -run 'TestPricing/region=cn'

命令中的正则表达式是筛选规则，不是 Name 的返回格式说明。名称里的斜杠、等号和点号都应按实际输出理解；如果测试名称来自外部数据，要避免把敏感信息、长文本或不可读内容直接放入名称。

确定 Name 的使用边界

可以把 t.Name() 用在三类地方：

测试函数重命名、父子层级调整、重复名称出现，都会改变返回值。若测试结果需要关联外部快照或固定样本，应另外定义稳定的样本 ID，把它作为测试数据字段；t.Name() 只负责描述当前运行上下文。

常见问题

t.Name() 只返回当前这一层吗？

不是。它会包含顶层测试名和嵌套子测试名，形成完整的测试路径。

两个同名子测试会返回完全相同的字符串吗？

不会。testing 会追加序号后缀来区分重复的兄弟名称。代码应读取最终返回值，不要自行推测后缀。

可以把 t.Name() 当作数据库主键吗？

不建议。名称服务于测试报告、日志和筛选，重构测试树就可能改变它；需要长期稳定的关联键时，应单独维护样本 ID。

归纳起来，testing.T.Name 的价值是把测试树转换成可读、可筛选的运行标识：用 t.Run 组织有意义的层级，在辅助函数中读取最终名称，遇到重复名称时信任 testing 的序号后缀，并把它限制在诊断上下文内。