17370845950

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 提供格式化能力，适合需要控制输出样式的场景：

• 用 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