Go 标准库 log 包不支持日志轮转,需用 github.com/natefinch/lumberjack 实现按大小轮转;它轻量、API 简洁,通过 Filename、MaxSize、MaxBackups 等配置实现自动归档与压缩,且 Write 并发安全。

Go 标准库的 log 包本身不支持日志轮转(如按大小或时间切分、归档旧文件),需借助第三方库或自行实现。最常用、稳定且符合生产要求的是 github.com/natefinch/lumberjack —— 它轻量、无依赖、API 简洁,专为 log.Writer 设计。
使用 lumberjack 实现按大小轮转
这是最常见场景:当日志文件达到指定大小(如 100MB),自动重命名旧文件(如 app.log.1)、创建新 app.log,并限制保留历史文件数量。
- 安装:
go get github.com/natefinch/lumberjack - 基础用法:将
lumberjack.Logger作为io.Writer传给log.SetOutput或log.New - 关键配置项:
-
Filename:日志主文件路径(如"logs/app.log") -
MaxSize:单个文件最大 MB 数(默认 100,单位是 MB,不是字节) -
MaxBackups:最多保留几个旧日志(如 5 表示保留app.log.1~app.log.5) -
MaxAge:旧日志最长保留天数(0 表示不限制) -
Compress:是否对归档文件启用 gzip 压缩(需 Go 1.16+)
-
完整可运行示例
以下代码启动一个日志器,每写入约 1MB 就触发轮转(便于测试),保留最多 3 个备份,自动压缩:
package main
<p>import (
"log"
"time"
"github.com/natefinch/lumberjack"
)</p><p>func main() {
logger := &lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 1, // MB
MaxBackups: 3,
MaxAge: 7,
Compress: true,
}</p><pre class="brush:php;toolbar:false;">// 将 lumberjack 作为输出目标
log.SetOutput(logger)
defer logger.Close() // 程序退出前关闭,确保缓冲写入
for i := 0; i < 100; i++ {
log.Printf("第 %d 条日志,时间:%s", i, time.Now().Format(time.RFC3339))
time.Sleep(100 * time.Millisecond)
}}
运行后你会看到:logs/app.log(当前写入中)、logs/app.log.1.gz、logs/app.log.2.gz、logs/app.log.3.gz(若已轮转多次)。
立即学习“go语言免费学习笔记(深入)”;
按时间轮转?lumberjack 不直接支持,但可组合实现
lumberjack 本身不检查“是否到整点/每天零点”,但可通过外部控制实现时间维度轮转:
- 方案一(推荐):用
MaxAge = 1+ 每日固定路径(如logs/app-2024-05-20.log),由程序在每日首次写日志时切换Filename—— 需自己维护io.Writer切换逻辑 - 方案二:配合系统 cron 或 systemd timer,每天定时执行脚本移动+压缩日志,Go 进程只负责写单一文件(简单但耦合运维)
- 替代库考虑:如
github.com/gogf/gf/v2/os/glog或github.com/rs/zerolog+ 自定义 sink,但复杂度上升,非必要不建议
注意事项与最佳实践
避免踩坑的关键细节:










