本文介绍如何通过重定向标准错误输出来捕获和验证 Go 程序中 log.Println 的日志内容，实现可靠的单元测试。
本文介绍如何通过重定向标准错误输出来捕获和验证 go 程序中 `log.println` 的日志内容，实现可靠的单元测试。
在 Go 中，log.Println 默认将日志写入 os.Stderr（标准错误），因此无法直接断言其输出。要对日志行为进行可重复、可验证的单元测试，核心思路是临时替换 log 包的输出目标——即用内存缓冲区（如 bytes.Buffer）替代 os.Stderr，执行被测逻辑后检查缓冲区内容。
以下是一个完整的测试示例：
package main
import (
"bytes"
"log"
"testing"
)
// 将原本的 main 逻辑封装为可测试函数（推荐实践）
func greet() {
log.Println("hello world")
}
func TestLogOutput(t *testing.T) {
// 1. 保存原始输出器并重定向
oldStderr := log.Writer()
defer log.SetOutput(oldStderr) // 测试后恢复，避免影响其他测试
// 2. 创建缓冲区并设置为 log 输出目标
var buf bytes.Buffer
log.SetOutput(&buf)
// 3. 执行被测逻辑
greet()
// 4. 断言输出内容（注意：log.Println 自动添加时间戳和换行符）
expected := "hello world\n" // 实际输出含前缀（如 "2024/01/01 12:00:00 hello world\n"）
// 若需精确匹配，应禁用默认前缀：
log.SetFlags(0) // 清除时间戳、文件名等前缀
buf.Reset()
log.SetOutput(&buf)
greet()
if got := buf.String(); got != expected {
t.Errorf("expected %q, got %q", expected, got)
}
}⚠️ 注意事项：
- 不要直接测试
func main()—— 它无参数、无返回值、难以注入依赖。应将业务逻辑提取到导出或包内函数中； -
log.SetOutput是全局操作，务必在测试结束前用defer恢复原始输出，否则可能干扰并发测试； -
log默认添加时间戳（Ldate|Ltime），若需稳定断言，请调用log.SetFlags(0)； - 生产代码中若需更灵活的日志控制（如多级别、结构化日志），建议迁移到
log/slog（Go 1.21+）或第三方库（如 Zap、Zerolog）。
通过上述方法，你就能在不依赖外部进程或文件 I/O 的前提下，精准、高效地测试 Go 日志输出行为。
