Golang如何使用testing.T记录日志_Golang testing.T日志记录实践

发布日期： 2025-11-25 阅读量： 作者： P粉602998670

应优先使用t.Log、t.Logf、t.Errorf和t.Fatal记录测试日志，确保输出与测试框架集成，避免使用fmt.Println或log包；t.Log和t.Logf用于输出调试信息，仅在失败或加-v时显示；t.Errorf标记错误但继续执行，t.Fatalf则立即终止测试；结合t.Run子测试可实现结构化日志输出，提升测试可读性与调试效率。

在 Go 语言中使用 testing.T 记录日志时，应优先使用 t.Log、t.Logf 和 t.Error 等方法，而不是 fmt.Println 或 log 包。这些方法能确保输出与测试框架集成，在测试失败时提供清晰上下文，且仅在测试失败或使用 -v 参数时才显示，避免污染正常输出。

使用 t.Log 和 t.Logf 输出调试信息

在编写单元测试过程中，经常需要查看中间状态或变量值。直接使用 fmt 打印会导致信息无法被测试框架管理。正确做法是通过 t.Log 系列方法记录：

t.Log("message")：记录普通调试信息，支持多个参数
t.Logf("format: %v", value)：格式化输出，类似 fmt.Printf
输出内容默认不显示，运行测试加 -v 参数可查看（如 go test -v）

func TestAdd(t *testing.T) {
  a, b := 2, 3
  t.Log("开始计算 a + b")
  t.Logf("输入值: a=%d, b=%d", a, b)
  result := a + b
  if result != 5 {
    t.Errorf("期望 5，实际 %d", result)
  }
}