日志轮转可防止日志文件过大，提升维护效率。使用lumberjack库可按大小或时间自动切割日志，支持压缩与备份，结合标准log包实现简单高效。
在Golang初级项目中，日志轮转与管理是保障程序可维护性和问题排查效率的重要环节。很多初学者直接使用
log包将信息输出到控制台或固定文件，但随着项目运行时间增长，日志文件会变得巨大，难以查看，甚至影响系统性能。因此，实现日志轮转（Log Rotation）是必要的。
为什么需要日志轮转
不进行日志轮转的程序容易产生单个巨大的日志文件，带来以下问题：
- 占用过多磁盘空间
- 打开和检索日志文件变得缓慢
- 不利于按时间或大小归档分析
- 线上服务难以维护
日志轮转通过按文件大小或时间周期自动切割日志，并支持压缩旧日志、保留指定数量的备份文件，有效解决上述问题。
使用 lumberjack 实现日志轮转
在Go生态中，
lumberjack是一个轻量且广泛使用的日志轮转库，专为
io.Writer设计，可与标准
log包或
zap等第三方日志库无缝集成。
立即学习“go语言免费学习笔记（深入）”；
安装 lumberjack：go get gopkg.in/natefinch/lumberjack.v2示例：使用标准 log 包 + lumberjack 按大小轮转
package main
import (
"log"
"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 输出到 lumberjack
log.SetOutput(logger)
// 模拟写入日志
for i := 0; i < 1000; i++ {
log.Printf("这是第 %d 条日志", i)
}
}
当
app.log达到10MB时，
lumberjack会自动将其重命名为
app.log.1，并创建新的
app.log继续写入。超过5个备份或7天的日志将被自动清理。
结合 zap 提供结构化日志（进阶建议）
对于稍复杂的项目，推荐使用
uber-go/zap，它性能高且支持结构化日志。配合
lumberjack也能轻松实现轮转。 示例：zap + lumberjack
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/app_structured.log",
MaxSize: 10,
MaxBackups: 5,
MaxAge: 7,
Compress: true,
})
// 构建 zap 日志核心
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"), zap.String("ip", "192.168.1.100"))
}
这种方式输出的是JSON格式日志，便于后续被ELK等系统采集分析。
日志目录初始化与权限处理
运行前确保日志目录存在，避免因路径不存在导致写入失败。
import "os"
func ensureLogDir() {
if err := os.MkdirAll("logs", 0755); err != nil {
log.Fatal("无法创建日志目录:", err)
}
}
在程序启动初期调用
ensureLogDir()，提升健壮性。
基本上就这些。对于初级Go项目，使用
lumberjack配合
log或
zap，合理配置大小、备份和压缩策略，就能实现简单高效的日志轮转与管理，无需自己造轮子。
