Golang log日志库分级与输出配置

P粉602998670

发布时间：2025-09-04 08:41:01

510人浏览过

来源于php中文网

原创

logrus支持日志分级与多输出配置，通过SetLevel设置级别，SetOutput配置输出目标；zap提供高性能结构化日志，NewProduction创建生产日志器，支持JSON格式输出，结合lumberjack实现日志轮转，适用于高并发场景。

golang log日志库分级与输出配置

Go语言标准库中的

log

包功能基础，不支持日志分级和多输出配置。在实际项目中，通常使用第三方日志库来实现更灵活的日志管理。以下是常用日志库的分级机制与输出配置方法，以

logrus

和

zap

为例进行说明。

日志分级机制

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

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

使用 logrus 配置分级与输出

logrus

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

安装：

CRMEB Min开源商城

CRMEB Min是CRMEB品牌全新推出的一款轻量级、高性能、前后端分离的开源电商系统，完善的后台权限管理、会员管理、订单管理、产品管理、客服系统、CMS管理、多端管理、页面DIY、数据统计、系统配置、组合数据管理、日志管理、数据库管理，一键开通短信、产品采集、物流查询等接口，系统采用TP6+Mysql+Uniapp+iView+Redis+workerman+form-builder等最流行热

下载

立即学习“go语言免费学习笔记（深入）”；

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

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, // 天
})

基本上就这些。选择