t.Log 输出仅在测试失败或启用-go test -v时显示,支持任意类型参数自动格式化,不可在init中调用且不属stdout;t.Logf仅多出格式化语法,二者行为一致。

在 Go 的测试中,t.Log 是最直接、轻量的调试信息输出方式,它只在测试失败或启用 -v(verbose)模式时才显示,既避免干扰正常测试输出,又能在需要时快速定位问题。
什么时候会看到 t.Log 的输出
t.Log 的内容默认不打印——这是关键设计。只有以下两种情况才会出现在终端:
- 测试执行失败(哪怕只是
t.Error或t.Fatal),所有该测试中调用的t.Log会一并输出 - 运行测试时加了
go test -v,此时每个测试开始前会显示名称,所有t.Log行实时打印
正确使用 t.Log 的写法
直接传入字符串、数字、结构体等任意可打印值,Go 会自动调用 fmt.Sprint 格式化:
- ✅ 推荐:
t.Log("request ID:", id, "status:", resp.Status) - ✅ 支持结构体:
t.Log(user)(会打印字段值) - ❌ 避免拼接字符串:
t.Log("user: " + user.Name)(易出错且失去类型优势)
和 t.Logf 的区别与选择
t.Logf 提供格式化能力,适合需要控制输出样式的场景:
立即学习“go语言免费学习笔记(深入)”;
- 用
t.Logf("got %v, want %v", got, want)替代重复写多个参数 - 调试循环时更清晰:
t.Logf("iteration %d: result=%s", i, s) - 两者行为完全一致,仅语法差异;无性能差别,按可读性选即可
常见误区提醒
t.Log 不是 stdout 输出,不能被重定向或捕获为标准输出流;它专属于测试上下文。因此:
- 不要试图用
os.Stdout替代t.Log(会始终打印,破坏静默约定) - 不要在
init()或包级变量初始化中调用t.Log(t仅在测试函数内有效) - 若需持续追踪(如性能压测日志),应结合外部日志库 + 文件写入,而非依赖
t.Log










