应优先使用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)
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)
}
}
错误日志使用 t.Errorf 和 t.Fatal
当检测到错误条件时,应使用 t.Errorf 主动报告问题。它会记录错误但继续执行后续逻辑,适合批量验证场景。若错误导致后续无法进行,可用 t.Fatal 立即终止。
- t.Errorf:记录错误并标记测试失败,继续执行
- t.Fatalf:记录错误后立即停止当前测试函数
- 两者都会在最终汇总中体现为失败用例
result, err := divide(10, 0)
if err == nil {
t.Fatal("除零操作应返回错误")
}
t.Logf("捕获预期错误: %v", err)
}
结合子测试使用独立日志上下文
Go 支持 t.Run 创建子测试,每个子测试拥有独立的执行环境和日志流。这有助于组织复杂测试用例,并使日志更具结构性。
立即学习“go语言免费学习笔记(深入)”;
func TestAPIHandler(t *testing.T) {t.Run("空参数检查", func(t *testing.T) {
t.Log("模拟请求: 缺少必要字段")
// ... 测试逻辑
t.Errorf("返回码应为400")
})
}
子测试中的日志会自动关联作用域,输出时更易定位问题来源。
基本上就这些。合理使用 testing.T 提供的日志方法,能让测试更可读、易调试,也符合 Go 社区的实践规范。










