Go testing.T.Log 怎样保留并发子测试的诊断上下文

并发子测试一多，最难读的往往不是断言，而是“这行诊断信息到底属于哪个分支”。直接用 fmt.Println 会把输出写到普通标准输出，难以和测试层级绑定；用 testing.T.Log 则能把文字挂到当前测试上下文。关键是要同时理解日志的可见时机、子测试名称和并发边界。

本文的做法是：用 t.Name() 形成稳定标识，用 t.Log 或 t.Logf 记录线索，并用 go test -v 在需要时展开成功测试的日志。

先分清 testing.T.Log 的输出时机

Log 会把参数按默认格式写入当前测试的错误日志；对普通测试来说，测试失败或启用 -test.v 时才会打印。Logf 只是把格式化过程换成类似 fmt.Printf 的方式，末尾没有换行时会自动补上。

func TestCacheLookup(t *testing.T) {
	// Log 记录当前测试的关键诊断，不会改变测试通过或失败状态。
	key := "user:42"
	t.Log("准备读取 key:", key)
	t.Logf("缓存层=%s，期望命中=%t", "memory", true)
}

这段代码通过测试时，普通 go test 可能不显示两条日志；使用 go test -v 才能主动展开。若断言失败，日志会随着失败测试一起保留，所以它更适合记录“为什么走到这里”的线索，而不是承担业务日志职责。

把子测试名称放进诊断上下文

在表格驱动测试里，日志本身通常不够。把 t.Name() 写进消息，能让失败分支和并发分支拥有可追踪的标识。t.Run 会创建子测试，名称还会包含嵌套层级；同名兄弟测试会由测试框架追加后缀保持唯一。

func TestParse(t *testing.T) {
	cases := []struct {
		name  string
		input string
	}{
		{name: "空输入", input: ""},
		{name: "带空格", input: " go "},
	}
	for _, tc := range cases {
		tc := tc // 注释：复制循环变量，避免并发子测试共享同一个迭代值。
		t.Run(tc.name, func(t *testing.T) {
			t.Logf("测试=%s，原始输入=%q", t.Name(), tc.input)
		})
	}
}

这里的诊断信息包含完整子测试名和输入摘要，排查时不需要猜测是哪一行数据。不要把完整敏感内容塞进日志；生产测试夹具应只记录足以定位问题的字段。

并发子测试怎样保留日志归属

并发只改变子测试何时运行，不会让 t.Log 失去当前测试对象。更重要的是，调用 t.Parallel() 后，闭包仍然必须使用当前迭代值，不能依赖会继续变化的共享变量。

func TestEndpoints(t *testing.T) {
	cases := []struct {
		name string
		path string
	}{
		{name: "健康检查", path: "/health"},
		{name: "版本信息", path: "/version"},
	}
	for _, tc := range cases {
		tc := tc // 注释：每个并发子测试保留自己的路径和名称。
		t.Run(tc.name, func(t *testing.T) {
			t.Parallel()
			t.Logf("子测试=%s，请求路径=%s", t.Name(), tc.path)
		})
	}
}

每条日志都应该从当前 *testing.T 写出。若另起 goroutine，必须保证它在测试返回前完成，否则在测试结束后继续调用 Log 或 Logf 会触发错误；也不要把 *testing.T 当成跨测试共享的日志器。

四个容易混淆的输出边界

第一，Log 不是失败断言。t.Log 只记录信息；需要让测试失败时，用 t.Error 或 t.Errorf，它们相当于记录错误后再标记失败。

第二，Log 不是无条件打印。想查看通过测试的诊断，使用 go test -v；不要因为默认输出没出现就判断 Log 没执行。

第三，Log 不能晚于测试生命周期。后台 goroutine 若在测试函数返回后才写日志，属于生命周期错误。应通过 channel、sync.WaitGroup 或测试内部的等待逻辑收拢它。

第四，调试信息要带边界。推荐记录子测试名、关键参数摘要和分支结果，不要输出令牌、完整请求体或与定位无关的大对象。

结语：把诊断信息写给对应的测试

要让并发子测试的日志可用，可以记住三个动作：在当前 *testing.T 上调用 Log/Logf，用 t.Name() 标识层级，必要时通过 go test -v 展开成功分支。这样日志既能跟随测试结果保留，又不会退化成难以归属的散乱标准输出。

相关问题

为什么普通 go test 看不到 t.Log？因为通过测试的日志默认不打印，使用 -v 可展开。

t.Log 和 t.Errorf 有什么区别？前者只记录诊断，后者记录错误并把测试标记为失败。

并发子测试能共用一个日志缓冲区吗？可以自行设计同步结构，但更简单的方式是让每个子测试直接使用自己的 *testing.T，并在测试返回前等待后台工作完成。