使用zap+Lumberjack实现Go日志写入与轮转，按大小、时间等策略切割日志，避免磁盘占满。1. 配置zap结合Lumberjack写入器，设置MaxSize、MaxBackups、MaxAge和Compress等参数控制日志文件数量、大小和保留时间。2. 使用JSON编码格式便于ELK等系统解析。3. 程序退出前调用Sync()确保日志落盘。4. 推荐单例模式管理logger，避免频繁创建。5. 新项目可用Go 1.21的slog标准库结合Lumberjack实现更简洁的日志处理。合理配置可提升系统稳定性和可观测性。
在Go语言开发中，日志是系统可观测性的重要组成部分。良好的日志写入与轮转机制能避免磁盘被占满，同时保证问题排查时有据可查。下面介绍如何在Golang中实现高效的日志文件写入与轮转管理。
使用 zap + lumberjack 实现日志写入与轮转
uber开源的zap是Go中性能极高的结构化日志库，配合lumberjack可以轻松实现日志轮转（按大小、时间、数量等策略）。
安装依赖：
go get go.uber.org/zap
go get github.com/natefinch/lumberjack
立即学习“go语言免费学习笔记（深入）”；
示例代码：
配置 zap 使用 lumberjack 作为写入器
```go
import (
"go.uber.org/zap"
"go.uber.org/zap/zapcore"
"github.com/natefinch/lumberjack"
)
func newLogger() *zap.Logger {
encoderCfg := zap.NewProductionEncoderConfig()
encoderCfg.TimeKey = "ts"
encoderCfg.EncodeTime = zapcore.ISO8601TimeEncoder
return zap.New(zapcore.NewCore(
zapcore.NewJSONEncoder(encoderCfg),
zapcore.AddSync(&lumberjack.Logger{
Filename: "/var/log/myapp.log", // 日志文件路径
MaxSize: 10, // 每个文件最大10MB
MaxBackups: 5, // 最多保留5个旧文件
MaxAge: 7, // 文件最多保留7天
Compress: true, // 是否压缩旧文件
}),
zapcore.InfoLevel,
))
}
```
使用日志：
AlegroCart新功能：维类：包括在这两种线性长宽高或面积或体积长波产品尺寸允许与期权产品：让产品/期权组合独特的数量，尺寸，图像和型号。选择店铺标识管理 图片放大镜：显示一个图片放大上空盘旋时，产品形象弹出框。自定义错误报告：设置在管理员启用。 开发者只可以显示详细的信息。错误信息都写入到错误日志文件每天可以通过电子邮件发送给管理员。仓库皮卡航运模块：允许客户指定产品在商店的位置回升。增加了
```go
logger := newLogger()
defer logger.Sync()
logger.Info("程序启动", zap.String("host", "localhost"))
```
轮转策略详解
lumberjack 支持的轮转参数说明：
- MaxSize：单个日志文件的最大大小（MB），达到后自动切割
- MaxBackups：保留的旧日志文件最大数量，超出后最老的被删除
- MaxAge：日志文件最长保留天数，过期自动清理
- Compress：是否启用gzip压缩归档日志，节省磁盘空间
- LocalTime：是否使用本地时间命名文件（默认UTC）
这些策略组合使用，能有效控制日志占用资源。
替代方案：log/slog（Go 1.21+）
Go 1.21 引入了标准库slog，轻量且功能完整。虽然标准库不直接支持轮转，但可以结合lumberjack实现：
```go
import (
"log/slog"
"github.com/natefinch/lumberjack"
)
handler := slog.NewJSONHandler(&lumberjack.Logger{
Filename: "app.log",
MaxSize: 10,
MaxBackups: 3,
MaxAge: 7,
}, nil)
logger := slog.New(handler)
slog.SetDefault(logger)
```
这种方式更简洁，适合新项目。
注意事项与最佳实践
关键点提醒：
- 始终调用logger.Sync()确保日志写入磁盘，特别是在程序退出前
- 避免在高并发场景频繁创建logger，应使用单例模式
- 生产环境建议使用JSON格式，便于日志采集系统（如ELK）解析
- 日志路径应配置为可外部传入（如通过flag或环境变量）
- 注意文件权限，确保进程有写入权限
基本上就这些，不复杂但容易忽略细节。合理配置轮转策略，能显著提升服务稳定性。
