Go 标准库 log 不支持日志轮转,需用第三方库:lumberjack 适合按大小轮转(如 100MB/个,保留 7 个+28 天),file-rotatelogs 适合按日期轮转(如 daily,带软链和精确时间控制)。

Go 标准库的 log 包本身不支持日志轮转(如按日期或文件大小自动切分),需借助第三方库或手动实现。最常用、稳定且轻量的方案是使用 github.com/lestrrat-go/file-rotatelogs(推荐)或 gopkg.in/natefinch/lumberjack.v2。下面分别说明两种主流方式,覆盖按时间(日期)和按大小轮转的典型场景。
使用 lumberjack 实现按大小自动轮转
适合:对日志时效性要求不高,更关注单个文件体积控制(如限制每个日志 ≤ 100MB,最多保留 7 个旧文件)
lumberjack 是一个简单可靠的日志切割器,常与标准 log 或 zap 等搭配使用:
- 安装:
go get gopkg.in/natefinch/lumberjack.v2 - 基本用法示例(配合标准 log):
import (
"log"
"os"
"gopkg.in/natefinch/lumberjack.v2"
)
func main() {
logger := log.New(&lumberjack.Logger{
Filename: "./logs/app.log",
MaxSize: 100, // MB
MaxBackups: 7, // 最多保留 7 个旧文件
MaxAge: 28, // 保留 28 天(即使没到 MaxBackups)
Compress: true, // 启用 gzip 压缩(.gz)
}, "", log.LstdFlags)
logger.Println("This is a log message")
}
注意:MaxAge 和 MaxBackups 是独立触发条件,任一满足即清理旧日志;Compress=true 会自动压缩归档文件(需 Go 1.16+)。
立即学习“go语言免费学习笔记(深入)”;
使用 file-rotatelogs 实现按日期轮转(如 daily)
适合:需要严格按日期归档(如 app-2024-05-20.log),便于按天检索、对接日志系统
file-rotatelogs 支持基于时间的精确轮转(秒/分/时/日),并可结合 logrus 或 zap 使用:
- 安装:
go get github.com/lestrrat-go/file-rotatelogs - 搭配标准 log 示例(按天切分):
import (
"log"
"time"
rotatelogs "github.com/lestrrat-go/file-rotatelogs"
"gopkg.in/natefinch/lumberjack.v2" // 可选:仅用于压缩,rotatelogs 本身不压缩
)
func main() {
writer, _ := rotatelogs.New(
"./logs/app-%Y-%m-%d.log", // 模板:%Y=年,%m=月,%d=日
rotatelogs.WithLinkName("./logs/app.log"), // 创建软链指向最新日志
rotatelogs.WithRotationTime(24*time.Hour), // 每 24 小时轮转一次
rotatelogs.WithMaxAge(7*24*time.Hour), // 保留最近 7 天
rotatelogs.WithRotationCount(7), // 最多存 7 个文件(与 MaxAge 二者取严)
)
logger := log.New(writer, "", log.LstdFlags)
logger.Println("Log written to dated file")
}
提示:WithLinkName 很实用——始终有 app.log 软链接指向当天日志,方便 tail -f;若需压缩,可额外用 lumberjack 封装 writer,或自行调用 os/exec 执行 gzip。
进阶建议:生产环境推荐组合方案
单一工具难兼顾所有需求。实际项目中建议:
- 优先用
lumberjack:简单、无依赖、稳定,适合大多数后端服务 - 如需精确日期命名 + 软链 + 高频轮转(如每小时),选
file-rotatelogs - 避免自己实现轮转逻辑:边界情况多(并发写、rename 冲突、磁盘满处理等),易出错
- 日志路径务必使用绝对路径或确保工作目录可控,防止日志写入意外位置
- 配合 systemd 或 supervisor 时,记得关闭其自带日志重定向,避免双重日志
小技巧:快速验证轮转是否生效
启动程序后,执行以下操作观察行为:
- 手动修改系统时间(测试 date-based 轮转)或快速写满设定大小(如设 MaxSize=1,反复打印)
- 检查日志目录:是否有新文件生成、旧文件是否重命名、软链是否更新
- 用
ls -lt logs/看文件时间顺序,tail -f logs/app.log确认输出流向正确文件










