golang 实现高效日志文件轮转主要依赖第三方库 lumberjack，结合 gzip 压缩与清理机制提升效率。1. 安装并配置 lumberjack 库，设置 filename、maxsize、maxbackups、maxage 等参数控制日志文件大小、保留数量和时长；2. 通过自定义钩子调用 compresslogfile 函数实现日志压缩，减少磁盘占用但需注意 cpu 开销；3. 编写 cleanupoldlogs 函数定期清理过期的压缩日志文件，弥补 lumberjack 对 .gz 文件不生效的清理策略；4. 注意日志写入性能优化、压缩时机选择及调试友好性，合理配置参数以达到高效管理日志的目的。
golang 实现高效日志文件轮转，主要依赖第三方库 lumberjack。它是一个简单但功能强大的日志切割工具，常用于按大小、时间或保留策略进行日志归档。结合 gzip 压缩，可以有效减少磁盘占用，同时保持日志可读性。
1. 安装与基本配置
使用 lumberjack 的第一步是安装：
go get gopkg.in/natefinch/lumberjack.v2
然后在代码中引入并配置：
立即学习“go语言免费学习笔记（深入）”；
import ( "gopkg.in/natefinch/lumberjack.v2" ) logger := &lumberjack.Logger{ Filename: "app.log", MaxSize: 10, // MB MaxBackups: 5, MaxAge: 7, // days LocalTime: true, }
- Filename 是当前写入的日志文件。
- MaxSize 控制单个文件最大容量，单位为MB。
- MaxBackups 设置保留的旧日志文件数量。
- MaxAge 表示保留天数，超过则删除。
- LocalTime 使用本地时间命名备份文件，更易读。
2. 日志压缩：gzip 配合处理
Lumberjack 本身不支持压缩，但可以通过自定义钩子（hook）实现自动压缩备份文件。一个常见的做法是在每次日志轮转后触发一个压缩操作。
例如，在调用 Write() 或者定时任务中执行压缩：
func compressLogFile(filename string) error { inFile, err := os.Open(filename) if err != nil { return err } defer inFile.Close() outFile, err := os.Create(filename + ".gz") if err != nil { return err } defer outFile.Close() gw := gzip.NewWriter(outFile) defer gw.Close() _, err = io.Copy(gw, inFile) return err }
这个函数接收一个日志文件路径，将其内容压缩为 .gz 文件。你可以在日志切换时调用它，比如监听某个事件，或者在主逻辑里判断是否新生成了日志文件。
注意：压缩会增加 CPU 开销，建议在非高峰时段执行，或者控制并发压缩数量。
3. 日志清理策略优化
默认情况下，lumberjack 会根据 MaxBackups 和 MaxAge 自动清理旧日志。但在实际使用中，如果启用了压缩，这些规则不会自动作用于 .gz 文件。
你可以手动编写一个清理函数：
func cleanupOldLogs(dir string, maxAgeDays int) error { now := time.Now() return filepath.Walk(dir, func(path string, info os.FileInfo, err error) error { if !info.IsDir() && strings.HasSuffix(info.Name(), ".gz") { age := now.Sub(info.ModTime()) if age > time.Duration(maxAgeDays)*24*time.Hour { os.Remove(path) } } return nil }) }
定期运行该函数，比如每天凌晨执行一次，就能确保压缩后的日志不会无限增长。
4. 一些细节和注意事项
- 日志写入性能：lumberjack 内部使用锁机制保证并发安全，但如果日志量非常大，可以考虑使用异步通道缓冲写入。
- 压缩时机选择：不要在每次写完就压缩，应该等一个完整日志文件切割后再执行，否则频繁压缩会影响性能。
- 日志恢复查看：虽然压缩节省空间，但查看时需要解压，建议保留最近几个未压缩的备份以方便调试。
基本上就这些。合理设置参数、配合压缩和清理机制，就可以让 Go 应用在生产环境中高效地管理日志文件。
