使用lumberjack库可实现Go日志自动轮转与归档，支持按大小或时间切割、压缩旧文件，并兼容标准log和zap日志库；结合zap可输出结构化JSON日志；也可自定义按天归档逻辑，通过文件重命名和信号触发实现，确保系统稳定高效运行。
Go语言开发中，日志轮转与归档是保障系统长期稳定运行的重要环节。默认的log包不支持自动轮转，需借助第三方库或自行实现。以下是常见且实用的实现方式。
使用 lumberjack 实现日志轮转
lumberjack 是 Go 生态中最常用的日志轮转库，可无缝集成 log 或 zap 等日志库。它按大小、时间、数量等条件自动切割日志文件并压缩归档。
安装：
go get gopkg.in/natefinch/lumberjack.v2示例代码（结合标准 log 库）：
立即学习“go语言免费学习笔记（深入）”；
package mainimport (
"io"
"log"
"os"
"gitlab.com/natefinch/lumberjack"
)
func main() {
logger := log.New(&lumberjack.Logger{
Filename: "/var/log/myapp.log", // 日志文件路径
MaxSize: 10, // 单个文件最大 MB 数
MaxBackups: 5, // 最多保留旧文件数
MaxAge: 30, // 文件最长保留天数
Compress: true, // 是否启用压缩（.gz）
}, "", log.LstdFlags)
logger.Println("这是一条测试日志")
}
上述配置会在日志文件达到 10MB 时自动轮转，最多保留 5 个历史文件，超过 30 天的自动删除，并对旧文件进行 gzip 压缩。
结合 zap 实现高性能结构化日志轮转
若项目使用 uber-go/zap，可搭配 lumberjack 实现结构化日志的高效轮转。
安装 zap：
go get go.uber.org/zap
示例：
package mainimport (
"go.uber.org/zap"
"go.uber.org/zap/zapcore"
"gitlab.com/natefinch/lumberjack"
)
func newZapLogger() *zap.Logger {
writeSyncer := zapcore.AddSync(&lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 10,
MaxBackups: 7,
MaxAge: 30,
Compress: true,
})
encoderCfg := zap.NewProductionEncoderConfig()
encoderCfg.TimeKey = "timestamp"
encoderCfg.EncodeTime = zapcore.ISO8601TimeEncoder
core := zapcore.NewCore(
zapcore.NewJSONEncoder(encoderCfg),
writeSyncer,
zap.InfoLevel,
)
return zap.New(core)
}
func main() {
logger := newZapLogger()
defer logger.Sync()
logger.Info("用户登录成功",
zap.String("user", "alice"),
zap.String("ip", "192.168.1.100"))
}
该方式输出 JSON 格式日志，便于集中采集和分析，同时具备高效的轮转与归档能力。
自定义轮转逻辑（按时间或手动触发）
在某些场景下，可能需要按小时或每天归档，或由外部信号触发轮转。可通过文件名加时间戳 + 重命名方式实现。
简单示例（每日日志）：
func getDailyLogFilename() string {return fmt.Sprintf("logs/app-%s.log", time.Now().Format("2006-01-02"))
}
func rotateByDay() *os.File {
filename := getDailyLogFilename()
file, err := os.OpenFile(filename, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
log.Fatalf("无法打开日志文件: %v", err)
}
return file
}
配合定时检查或 SIGHUP 信号重新打开文件句柄，即可实现按天归档。
基本上就这些。lumberjack 能满足大多数生产需求，若需更复杂策略（如按内容分类归档），可在其基础上封装。关键是确保归档不影响主流程性能，并定期清理过期文件。
