如何使用Golang log记录日志信息_自定义输出格式和日志等级

技术教程
2025-12-18 08:36:07

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

如何使用golang log记录日志信息_自定义输出格式和日志等级

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语言免费学习笔记（深入）”；

iSlide PPT

DeepSeek AI加持，输入主题生成专业PPT，支持Word/PDF等45种文档导入，职场汇报、教学提案轻松搞定

375 查看详情 iSlide PPT

初始化时设置输出（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 压力过大