Golang日志格式与等级自定义设置

Go标准库的log包虽轻量但缺乏日志等级、结构化输出和丰富格式支持，难以满足生产环境需求；本文深入对比了两种实用方案：一是基于标准log手动封装多实例实现分级与格式定制（适合简单场景），二是推荐采用功能完备、生态成熟的logrus库——它原生支持DEBUG/INFO/WARN/ERROR等级、结构化字段注入、彩色/JSON多格式输出及环境动态配置（如开发期高信息量+颜色，生产期精简+文件写入），并提醒关注敏感数据脱敏、性能影响与统一日志采集（如ELK/Loki）等关键实践，为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学习网公众号！