Golanglog包使用与日志记录详解

Go标准库的log包虽轻量简洁，但其默认配置（无时间戳、无日志级别、固定输出到stderr且不可重定向）在生产环境中极易导致问题定位困难；本文深入剖析了其局限性，手把手教你通过自定义logger实例、合理设置flag和输出目标来实现基础增强，并揭示了log.SetFlags/SetOutput易被误解的“全局性”陷阱，还提供了简洁可复用的带级别封装方案——既夯实底层原理认知，又为平滑过渡到zap、zerolog等专业日志库打下坚实基础。

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)

关键点：

• 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 阻塞了。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。