Logrus 是 Go 项目中标准 log 的优秀替代，支持结构化输出、多级日志控制和自定义格式。通过导入 logrus 并设置全局 logger，可轻松替换标准库：使用 SetOutput 指定输出目标（如文件或 stdout），SetLevel 控制日志级别，SetFormatter 配置文本或 JSON 格式以适应开发或生产环境。利用 WithField(s) 方法添加上下文字段，实现请求追踪；结合 lumberjack 库实现日志轮转，避免磁盘溢出。示例代码展示了初始化配置及带上下文的日志记录方式，显著提升日志可读性与运维效率。
Go 的标准库提供了 log 包，虽然简单易用，但在实际项目中往往需要更灵活的日志级别、结构化输出和更好的格式支持。Logrus 是一个功能强大的第三方日志库，能很好地替代标准日志，支持结构化日志（如 JSON）、自定义输出格式和多级日志控制。
使用 Logrus 替换标准日志
要替换 Go 标准库的 log，只需将全局 logger 替换为 Logrus 实例，并确保所有日志调用都通过它进行。
Logrus 提供了与标准 log 兼容的接口，可以轻松迁移：
- 导入 logrus 并初始化全局 logger
- 设置 logrus 输出目标（如文件或 stdout）
- 使用 logrus 提供的方法（Infof, Error, Warn 等）代替 log.Printf 等
package main
import (
"os"
"github.com/sirupsen/logrus"
)
func init() {
// 设置输出为标准输出
logrus.SetOutput(os.Stdout)
// 可选：设置日志级别
logrus.SetLevel(logrus.InfoLevel)
// 可选：设置文本或 JSON 格式
logrus.SetFormatter(&logrus.TextFormatter{
FullTimestamp: true,
})
}
func main() {
logrus.Info("程序启动")
logrus.WithField("user", "alice").Warn("登录尝试频繁")
logrus.WithFields(logrus.Fields{
"method": "GET",
"path": "/api/data",
"status": 200,
}).Info("HTTP 请求完成")
}
优化日志输出格式
Logrus 支持多种输出格式，可根据环境选择合适的格式提升可读性或便于机器解析。
立即学习“go语言免费学习笔记（深入）”；
- TextFormatter：适合开发环境，人类可读
- JSONFormatter：适合生产环境，便于日志系统（如 ELK）采集
logrus.SetFormatter(&logrus.JSONFormatter{
PrettyPrint: true, // 格式化输出，便于调试
})
还可以自定义时间格式、字段名称等，满足团队规范。
添加上下文字段增强日志信息
Logrus 的 WithField(s) 方法允许在每条日志中附加上下文，避免重复传参。
- 使用
WithField添加单个字段 - 使用
WithFields批量添加 map 类型字段 - 可链式调用，构建带上下文的 entry
例如在处理请求时，可以封装一个带 request_id 的 logger：
logger := logrus.WithFields(logrus.Fields{
"request_id": "abc123",
"user_id": 456,
})
logger.Info("开始处理订单")
logger.Error("支付失败")
这样每条日志都会自动带上上下文，便于追踪问题。
输出到文件并结合滚动策略
默认输出到终端，生产环境通常需要写入文件。可将 logrus 输出重定向到文件句柄。
file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
logrus.Fatal("无法打开日志文件:", err)
}
logrus.SetOutput(file)
若需日志轮转（按大小或时间），建议结合 lumberjack 库：
import "gopkg.in/natefinch/lumberjack.v2"
logrus.SetOutput(&lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 10, // MB
MaxBackups: 5,
MaxAge: 7, // 天
Compress: true, // 启用压缩
})
这样可自动管理日志文件，防止磁盘被占满。
基本上就这些。Logrus 能显著提升 Go 项目的日志能力，结构清晰、扩展性强，是标准 log 的优秀替代方案。
