Go标准库log包功能简单,生产环境需自定义等级和格式:可用多logger实例模拟分级,或选用logrus/zap等第三方库;logrus支持结构化日志、多格式输出及环境动态配置,推荐用于正式项目。

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),且天然支持等级。
立即学习“go语言免费学习笔记(深入)”;
- 初始化时设置输出(
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 格式 + 结构化字段










