Go testing.T.Name 怎样在辅助函数中获取当前测试名称

在 Go 测试辅助函数里想知道“当前到底是哪条用例”，不要手动拼接父测试名，也不要从日志文本反推。把 *testing.T 传入辅助函数，直接调用 t.Name() 即可。它会返回当前测试或子测试的完整名称；如果存在嵌套子测试，还会包含对应的层级。

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

t.Name() 适合做测试诊断、日志前缀和失败信息上下文。它是运行时名称，不应直接当作永久业务 ID 或跨版本稳定的存储键。

T.Name 返回的是当前测试的完整路径

testing.T.Name 的签名是 func (c *T) Name() string。在顶层测试中，结果通常对应 TestXxx；在 t.Run 创建的子测试中，结果会把父测试和嵌套子测试名组合起来。兄弟子测试如果使用了相同名称，Go 会追加后缀来保证返回值唯一。

辅助函数中怎样拿到当前测试名称

辅助函数不需要接收一个字符串形式的测试名，只要接收 *testing.T 就能读取调用时的上下文。通常先调用 t.Helper()，让失败位置更接近测试调用方，再用 t.Name() 组织诊断信息。

package demo

import (
	"fmt"
	"testing"
)

func reportCase(t *testing.T, got, want int) {
	// Helper 让断言失败时的文件和行号更接近调用方。
	t.Helper()
	// Name 读取当前测试或子测试的完整名称，不需要手动拼接父级。
	caseName := t.Name()
	if got != want {
		// 把名称放进错误上下文，便于区分并列用例。
		t.Errorf("%s: got=%d, want=%d", caseName, got, want)
		return
	}
	// 这里只展示名称的使用方式，实际项目可改成 t.Logf 或结构化记录。
	fmt.Printf("%s passed\\n", caseName)
}

func TestTotal(t *testing.T) {
	// 辅助函数通过 *testing.T 获取当前测试上下文。
	reportCase(t, 3, 3)
}

关键点是“传递测试对象”，而不是传递一个可能过期的字符串。如果辅助函数内部继续创建子测试，也应把新回调收到的 *testing.T 继续向下传递；这样每一层调用 Name() 时，拿到的都是自己的上下文。

表驱动测试中怎样让日志自动带上用例名

表驱动测试可以把短名称放在测试数据里，再由 t.Run 建立测试层级。辅助函数只依赖当前的 *testing.T，所以同一套断言逻辑既能用于顶层测试，也能用于更深的子测试。

func TestParseAmount(t *testing.T) {
	cases := []struct {
		name string
		input string
		want int
	}{
		{"integer", "12", 12},
		{"zero", "0", 0},
	}

	for _, tc := range cases {
		tc := tc // 为每次回调保留当前用例数据。
		t.Run(tc.name, func(t *testing.T) {
			// 子测试回调中的 t.Name 包含父测试和当前用例名。
			got := parseAmount(tc.input)
			t.Logf("case=%s input=%q", t.Name(), tc.input)
			if got != tc.want {
				// 失败信息直接使用框架生成的完整名称。
				t.Fatalf("got=%d, want=%d", got, tc.want)
			}
		})
	}
}

这里不需要额外维护 parentName + "/" + tc.name。如果两个兄弟用例的名称相同，框架会对返回名称做唯一化处理；日志中的 t.Name() 因而比手工拼接更接近实际执行上下文。示例里的 parseAmount 代表文章主题之外的被测函数，重点是测试对象和名称的传递关系。

名称适合诊断，不适合当永久标识

1. 用于日志和错误上下文。名称能帮助快速定位哪条测试失败，尤其适合在公共断言、fixture 和清理辅助函数里使用。
2. 不要假定短名称永远不变。父测试重命名、嵌套层级调整或同名用例都会改变完整结果。
3. 不要把 Name 当筛选 API。需要选择测试时使用 go test 的匹配参数和明确的测试命名约定，辅助函数只负责读取当前上下文。
4. 并发场景仍传递当前 t。不要把某个测试的名称缓存成全局变量；每个测试回调收到的 *testing.T 才是对应上下文。

如果只想让失败位置指向测试调用方，使用 t.Helper()；如果想让日志知道当前用例，使用 t.Name()。两者解决的是不同问题，可以在同一个辅助函数中配合。

常见问题

t.Name() 会只返回 t.Run 传入的短名称吗？

不一定。子测试名称会包含父测试和嵌套层级；同名兄弟还可能被追加后缀。需要完整诊断上下文时，应直接使用返回值。

辅助函数里能不能直接调用 t.Name()？

可以。把当前回调收到的 *testing.T 作为参数传入即可，通常同时调用 t.Helper() 改善失败位置显示。

能不能把 t.Name() 存进测试结果文件作为唯一键？

不建议把它当永久键。它保证运行时的测试名称在同级场景下可区分，但测试结构或命名改变后，结果字符串也会变化。

总结：辅助函数不要猜测试名，接收 *testing.T 后调用 t.Name()；表驱动测试让 t.Run 建立层级；诊断用途和业务标识用途要分开。