Go 标准库 log 包需通过 io.MultiWriter 实现终端与文件双写入,并用 %+v 格式化错误以保留堆栈;可封装带前缀的 logger 模拟级别,大规模项目推荐 zap 或 zerolog 等结构化日志库。

Go 语言标准库的 log 包本身不直接支持错误类型自动展开,但通过合理封装和组合,可以实现「错误信息 + 上下文日志」同时输出到文件和终端,并保持结构清晰、可读性强。
使用 log.SetOutput 同时写入多目标
Go 的 log.Logger 支持自定义输出目标(io.Writer)。你可以用 io.MultiWriter 将日志同时发给 os.Stdout 和文件句柄:
- 打开日志文件(建议用
os.OpenFile配合os.O_APPEND | os.O_CREATE | os.O_WRONLY) - 创建
io.MultiWriter,传入os.Stdout和文件句柄 - 调用
log.SetOutput或新建log.New实例绑定该 writer
这样所有 log.Print/Printf/Println 调用都会同步出现在终端和文件中。
让错误对象自动转为可读字符串
标准 log 打印 error 时默认只调用 err.Error(),丢失堆栈。推荐两种轻量方案:
立即学习“go语言免费学习笔记(深入)”;
-
用
fmt.Printf("%+v", err):若使用github.com/pkg/errors或 Go 1.13+ 的errors.Unwrap/%w,%+v可显示完整调用链 -
封装一个带错误上下文的日志函数,例如:
func LogError(msg string, err error) {
log.Printf("%s: %+v", msg, err)
}
这样既保留业务提示(如 "failed to parse config"),又附带结构化错误详情。
区分日志级别并保留错误语义
标准 log 没有内置级别,但可通过前缀模拟(如 [ERROR]、[WARN]):
- 定义不同 logger 实例:
log.New(mw, "[ERROR] ", log.LstdFlags) - 在错误路径中统一使用
errorLogger.Println(...),正常流程用infoLogger - 关键错误建议额外调用
log.Fatal(会自动加换行并退出),或手动os.Exit(1)
注意:不要把非致命错误都塞进 Fatal,否则掩盖真正需终止的场景。
进阶:结构化日志(可选)
如果项目规模上升,建议切换到结构化日志库,比如:
-
zap(高性能,推荐生产):支持
logger.Error("db query failed", zap.Error(err), zap.String("query", sql)) -
zerolog(零分配,链式 API):
log.Error().Err(err).Str("path", r.URL.Path).Msg("request failed")
它们天然支持错误字段序列化、JSON 输出、多写入器(console + file + network),比手写更健壮且易扩展。










