Golang日志分级与输出配置教程

Go语言标准库中的log包功能基础，不支持日志分级和多输出配置。在实际项目中，通常使用第三方日志库来实现更灵活的日志管理。以下是常用日志库的分级机制与输出配置方法，以logrus和zap为例进行说明。

日志分级机制

主流日志库都支持常见的日志级别，用于区分日志的重要程度：

• Debug：调试信息，开发阶段使用
• Info：普通运行信息，用于记录流程
• Warn：警告，表示潜在问题
• Error：错误，表示出错但程序仍可运行
• Fatal：严重错误，记录后调用os.Exit(1)
• Panic：最高级别，记录后触发panic

使用 logrus 配置分级与输出

logrus 是一个功能丰富且易于使用的日志库，支持结构化日志和多输出。

安装：

go get github.com/sirupsen/logrus

示例配置：

package main

import (
    "os"
    "github.com/sirupsen/logrus"
)

func main() {
    // 设置日志格式为JSON（可选）
    logrus.SetFormatter(&logrus.JSONFormatter{})

    // 设置日志输出位置，可同时输出到文件和标准输出
    file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err == nil {
        logrus.SetOutput(file)
    } else {
        logrus.Info("无法打开日志文件，使用默认输出")
    }

    // 可同时输出到多个位置
    // logrus.SetOutput(io.MultiWriter(file, os.Stdout))

    // 设置最低日志级别
    logrus.SetLevel(logrus.DebugLevel)

    // 使用不同级别记录日志
    logrus.Debug("这是调试信息")
    logrus.Info("这是普通信息")
    logrus.Warn("这是警告")
    logrus.Error("这是错误")
}

使用 zap 配置高性能日志

zap 是 Uber 开源的高性能日志库，适合生产环境。

安装：

go get go.uber.org/zap

示例配置：

package main

import (
    "go.uber.org/zap"
)

func main() {
    // 创建生产级别 logger（自动区分级别，输出到文件和 stderr）
    logger, _ := zap.NewProduction()
    defer logger.Sync()

    logger.Debug("这不会输出，因为生产配置默认级别为 INFO")
    logger.Info("服务启动", zap.String("host", "localhost"), zap.Int("port", 8080))
    logger.Warn("内存使用偏高", zap.Float64("usage", 0.85))
    logger.Error("数据库连接失败", zap.Error(err))

    // 创建开发级别 logger，支持更详细输出
    devLogger, _ := zap.NewDevelopment()
    defer devLogger.Sync()
    devLogger.Debug("这是调试日志，仅在开发环境显示")
}

自定义 zap 配置：

cfg := zap.Config{
    Level:       zap.NewAtomicLevelAt(zap.DebugLevel),
    Encoding:    "json",
    OutputPaths: []string{"app.log", "stderr"},
    EncoderConfig: zapcore.EncoderConfig{
        MessageKey: "msg",
        LevelKey:   "level",
        EncodeLevel: zapcore.CapitalLevelEncoder,
    },
}
logger, _ := cfg.Build()

输出配置建议

根据环境合理配置输出目标和格式：

• 开发环境使用TextEncoder和DebugLevel，便于阅读
• 生产环境使用JSONEncoder，便于日志系统采集
• 错误日志可单独输出到特定文件，便于监控
• 结合lumberjack实现日志轮转

例如，使用lumberjack进行日志切割：

import "gopkg.in/natefinch/lumberjack.v2"

logger.SetOutput(&lumberjack.Logger{
    Filename:   "logs/app.log",
    MaxSize:    10, // MB
    MaxBackups: 5,
    MaxAge:     30, // 天
})

基本上就这些。选择logrus还是zap取决于性能要求和复杂度偏好。logrus更简单易用，zap更适合高并发场景。