Golang日志格式与等级设置详解

本文深入讲解了Go语言中日志处理的核心实践，从标准库log包的局限性出发，系统介绍了如何通过多实例封装实现基础的日志分级与格式化，更重点推荐并演示了logrus这一主流第三方库在结构化日志、多环境动态配置（开发/生产）、上下文字段注入、JSON/文本双格式输出等方面的强大能力，同时兼顾性能敏感场景下zap的选型建议及安全、可观测性等生产级最佳实践，为Go开发者提供了一套即学即用、面向真实项目的日志解决方案。

Go 标准库的 log 包简单轻量，但默认只支持基础文本输出、无日志等级、不带时间戳和调用位置，不适合生产环境。要实现自定义格式和分级控制，通常有两种方式：一是基于标准 log 手动封装（适合轻量需求），二是使用成熟第三方库如 logrus 或 zap（推荐用于正式项目）。下面分场景说明实用做法。

用标准 log 实现带等级和格式的日志

标准 log 本身不内置等级，但可通过前缀 + 多个 logger 实例模拟：

• 为每个等级（DEBUG/INFO/WARN/ERROR）创建独立的 *log.Logger，用 log.New 指定输出目标、前缀和标志
• 常用标志组合：log.LstdFlags | log.Lshortfile（含时间+文件行号）
• 前缀可设为 [INFO] 、[ERROR] 等，便于肉眼识别级别

示例：

var (
    InfoLog  = log.New(os.Stdout, "[INFO] ", log.LstdFlags|log.Lshortfile)
    WarnLog  = log.New(os.Stdout, "[WARN] ", log.LstdFlags|log.Lshortfile)
    ErrorLog = log.New(os.Stderr, "[ERROR] ", log.LstdFlags|log.Lshortfile)
)

InfoLog.Println("服务启动完成")
ErrorLog.Printf("数据库连接失败: %v", err)

使用 logrus 实现结构化、可配置的日志

logrus 是最常用的 Go 日志库，支持字段注入、多输出、Hook 和多种格式（文本/JSON），且天然支持等级。

• 初始化时设置输出（logrus.SetOutput）、格式（logrus.SetFormatter）和等级（logrus.SetLevel）
• 推荐使用 logrus.TextFormatter（带颜色、时间、级别、调用信息）或 logrus.JSONFormatter（适合日志采集系统）
• 通过 WithField 或 WithFields 添加上下文字段，如 req_id、user_id

示例：

logrus.SetLevel(logrus.InfoLevel)
logrus.SetFormatter(&logrus.TextFormatter{
    FullTimestamp:   true,
    DisableColors:   false,
    DisableSorting:  true,
})

logrus.WithFields(logrus.Fields{
    "user_id": 123,
    "action":  "login",
}).Info("用户登录成功")

按环境动态切换日志行为

开发时需详细信息（含调试级、颜色、文件位置），生产环境则倾向简洁、无颜色、写入文件或 syslog：

• 用环境变量（如 ENV=prod）控制日志等级和格式
• 生产环境将输出重定向到文件：logrus.SetOutput(os.OpenFile("app.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644))
• 避免在生产开启 DebugLevel，防止敏感信息泄露或 I/O 压力过大

注意点与建议

无论用标准库还是 logrus，都需注意：

• 不要在日志中拼接敏感数据（密码、token），必要时脱敏后再记录
• 避免在循环或高频路径中记录 Debug 日志，影响性能
• 若对性能极致敏感（如微服务核心链路），优先考虑 uber-go/zap，它零分配、异步写入、速度快数倍
• 所有日志最终应接入统一收集系统（如 ELK、Loki），因此推荐 JSON 格式 + 结构化字段

理论要掌握，实操不能落！以上关于《Golang日志格式与等级设置详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！