如何在 Go 中实现带日志轮转的文件记录（跨平台兼容）
本文介绍使用 lumberjack 库为 Go 标准 log 包添加自动日志轮转能力，支持 Linux 和 Windows 环境，无需修改现有 log 调用代码，即可实现按大小、备份数量和保留天数智能管理日志文件。
在 Go Web 应用中，生产环境的日志需兼顾可靠性、可维护性与跨平台兼容性。标准库 log 包功能简洁但不支持轮转；而许多第三方日志库（如 zap、logrus）虽强大，却往往要求重写日志调用逻辑，且部分依赖平台特定特性，难以无缝适配 Windows + Linux 混合部署场景。
推荐方案：lumberjack —— 专为标准 log 设计的轻量级轮转封装
lumberjack（GitHub: natefinch/lumberjack）是一个零依赖、纯 Go 实现的轮转日志写入器，完全兼容 io.Writer 接口。它可直接作为 log.SetOutput() 的参数，无需侵入式改造原有 log.Printf、log.Fatal 等调用，天然满足“适用于所有使用标准 log 的包”这一关键需求，并经实测在 Windows 和各类 Unix-like 系统上行为一致。
✅ 快速集成步骤
-
安装依赖（Go Modules 推荐方式）：
go get github.com/natefinch/lumberjack
-
配置日志输出（示例：主程序初始化）：
package main import ( "log" "os" "github.com/natefinch/lumberjack" ) var logger *log.Logger func main() { // 创建 lumberjack 轮转写入器 lumberjackLogger := &lumberjack.Logger{ Filename: "./app.log", // 日志主文件路径（自动创建目录） MaxSize: 10, // 单个日志文件最大大小（MB） MaxBackups: 5, // 最多保留几个历史备份文件 MaxAge: 30, // 备份文件最长保留天数（0 表示不限） Compress: true, // 是否启用 gzip 压缩（需 Go 1.16+）
} // 将标准 log 输出重定向至 lumberjack logger = log.New(lumberjackLogger, "", log.Ldate|log.Ltime|log.Lshortfile) // ✅ 此后所有标准 log 调用均自动轮转 logger.Println("服务启动成功") logger.Printf("监听端口: %s", ":8080") }
⚠️ 关键注意事项
- 无需预先创建文件或目录：lumberjack 内部会自动创建缺失的目录结构（如 ./logs/app.log），避免因路径不存在导致 panic。
- 线程安全：lumberjack.Logger 是并发安全的，可被多个 goroutine 同时写入，适合高并发 Web 场景。
- Windows 兼容性已验证：内部使用 os.Rename 和 os.Remove（而非 Unix 专用 syscall），在 Windows 上同样可靠。
- MaxAge 与 MaxBackups 协同生效：当两者同时设置时，任一条件触发即清理旧日志（例如：即使只保留 2 个备份，但某备份已超 30 天，仍会被删除）。
- 慎用 os.OpenFile 预打开：原文示例中手动 OpenFile 并非必需，反而可能引发文件句柄冲突；直接将 &lumberjack.Logger{} 传给 SetOutput() 即可。
? 总结
lumberjack 是解决 Go 标准日志轮转问题的“最小可行方案”：它不引入新日志 API，不破坏现有代码结构，不增加平台耦合，却完整覆盖了生产环境所需的轮转策略（大小/数量/时效）。对于追求稳定、简洁与跨平台一致性的中小型 Go 服务，它是比全功能日志框架更务实的选择。只需几行配置，即可让 log 包焕发新生——真正实现“零改造，有轮转”。
