Go 标准库 log 包默认不带时间戳、无级别区分、输出固定到 stderr 且不可重定向,因此不适合生产环境;需显式创建自定义 logger 并设置 flag 和输出目标,或封装带级别的结构体。

Go 标准库 log 包足够轻量,但默认输出不带时间戳、不区分级别、不能直接写文件——直接用 log.Println() 往控制台一打,线上出问题时基本没法定位。
log 默认输出为什么不适合生产环境
默认的 log.Logger 实例(即 log.Print/log.Printf 等)底层调用的是 log.New(os.Stderr, "", 0),第三个参数 flag 为 0,意味着:
- 没有时间戳(
log.Ldate | log.Ltime没启用) - 没有文件名和行号(
log.Lshortfile或log.Llongfile未设置) - 输出目标固定为
os.Stderr,无法重定向到文件或网络日志服务 - 不支持日志级别(INFO/WARN/ERROR),所有输出平权处理
如何自定义 log.Logger 实现基础增强
必须显式创建新实例,并传入合适的 flag 和输出目标。常见组合:
logger := log.New(os.Stdout,
"[INFO] ",
log.Ldate|log.Ltime|log.Lshortfile)
关键点:
立即学习“go语言免费学习笔记(深入)”;
-
os.Stdout可替换为os.Stderr或打开的文件句柄(如os.OpenFile(...)) -
"[INFO] "是每条日志前缀,可用于模拟级别(注意:只是字符串,无逻辑含义) -
log.Lshortfile输出main.go:23,log.Llongfile输出完整路径 - 避免混用
log.Printf(全局默认 logger)和自定义 logger,容易混乱
log.SetOutput() 和 log.SetFlags() 的坑
这两个函数修改的是全局默认 logger,不是你 new 出来的实例——它们只影响 log.Print 系列函数:
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.SetOutput(os.Stdout)
log.Println("这行会受上面两行影响")
logger := log.New(os.Stderr, "", 0) // 这个 logger 完全不受影响
logger.Println("这行仍按自己的 flag 和 output 走")
所以:
- 不要依赖
SetFlags去配置自定义 logger - 如果项目里混用了全局
log.Print*和自定义 logger,行为会割裂 - 多 goroutine 写同一个
*log.Logger是安全的,但写同一个文件句柄需注意并发(标准log内部已加锁)
简单封装一个带级别的日志助手
标准 log 不提供级别 API,但可用结构体包装 + 方法收口来统一管理:
type Logger struct {
info *log.Logger
warn *log.Logger
err *log.Logger
}
func NewLogger(out io.Writer) *Logger {
return &Logger{
info: log.New(out, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile),
warn: log.New(out, "[WARN] ", log.Ldate|log.Ltime|log.Lshortfile),
err: log.New(out, "[ERROR] ", log.Ldate|log.Ltime|log.Lshortfile),
}
}
func (l *Logger) Info(v ...interface{}) {
l.info.Println(v...)
}
func (l *Logger) Warn(v ...interface{}) {
l.warn.Println(v...)
}
func (l *Logger) Error(v ...interface{}) {
l.err.Println(v...)
}
这样调用清晰:logger.Info("user login", "id", userID)。但注意:
- 仍不支持结构化日志(如 JSON 键值对),需要额外序列化
- 如果要切换输出目标(比如开发用 stdout,生产写文件),需在
NewLogger时传入对应io.Writer - 别在
Info方法里做格式拼接(如sprintf),让log.Println自己处理可变参数更高效
真正上线时,多数团队会切到 zap 或 zerolog,因为标准 log 缺少异步写入、采样、字段注入等能力;但理解它怎么工作,能帮你快速诊断日志没出来是配置错了还是 IO 阻塞了。










