如何使用Golang实现日志文件滚动-Golang-PHP中文网

如何使用Golang实现日志文件滚动

P粉602998670

发布： 2025-10-02 10:28:02

原创

525人浏览过

日志文件滚动可通过lumberjack库实现，结合标准log库按大小或时间自动切割日志。配置包括文件路径、最大尺寸、保留数量及压缩选项，并通过log.SetOutput重定向输出。

如何使用golang实现日志文件滚动

日志文件滚动是服务长期运行中避免磁盘占满的关键措施。Golang标准库没有直接支持日志轮转，但可以通过第三方库或自己封装实现。最常用的方式是结合 lumberjack 库，它专为 Go 设计，与 log 或 zap 等日志库无缝集成。

使用 lumberjack 实现日志滚动

lumberjack 是一个轻量级的日志切割库，支持按大小、日期、压缩等策略自动滚动日志文件。

安装 lumberjack：

go get gopkg.in/natefinch/lumberjack.v2

示例：结合标准 log 库写入滚动日志

package main

import (
    "log"
    "os"

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

func main() {
    // 配置 lumberjack 作为日志输出
    logger := &lumberjack.Logger{
        Filename:   "logs/app.log",     // 日志文件路径
        MaxSize:    10,                 // 每个文件最大 10MB
        MaxBackups: 5,                  // 最多保留 5 个旧文件
        MaxAge:     7,                  // 文件最多保存 7 天
        Compress:   true,               // 启用 gzip 压缩旧文件
    }

    defer logger.Close()

    // 使用 log.SetOutput 将日志重定向到 lumberjack
    log.SetOutput(logger)
    log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)

    // 写入测试日志
    for i := 0; i < 1000; i++ {
        log.Printf("这是第 %d 条日志", i)
    }
}

登录后复制

与 zap 日志库结合（高性能场景）

如果你使用 uber-go/zap（常用于高性能服务），也可以将 lumberjack 作为写入目标。

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

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

安装 zap：

go get go.uber.org/zap

示例代码：

package main

import (
    "gopkg.in/natefinch/lumberjack.v2"
    "go.uber.org/zap"
    "go.uber.org/zap/zapcore"
)

func main() {
    // 配置 lumberjack 写入器
    writeSyncer := zapcore.AddSync(&lumberjack.Logger{
        Filename:   "logs/zap.log",
        MaxSize:    10,
        MaxBackups: 5,
        MaxAge:     7,
        Compress:   true,
    })

    // 构建 zap core
    encoderCfg := zap.NewProductionEncoderConfig()
    encoderCfg.TimeKey = "ts"
    encoderCfg.EncodeTime = zapcore.ISO8601TimeEncoder

    core := zapcore.NewCore(
        zapcore.NewJSONEncoder(encoderCfg),
        writeSyncer,
        zap.InfoLevel,
    )

    logger := zap.New(core)
    defer logger.Sync()

    // 写日志
    logger.Info("用户登录", zap.String("user", "alice"))
}

登录后复制