如何使用Golang实现日志文件轮转_按日期或大小切分日志

小静小哥_9809

小静小哥_9809

2025-12-18

912人浏览

原创

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

如何使用golang实现日志文件轮转_按日期或大小切分日志

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+)。

使用 file-rotatelogs 实现按日期轮转(如 daily)

适合:需要严格按日期归档(如 app-2024-05-20.log),便于按天检索、对接日志系统

git-push
git-push

自动用 git 提交代码并推送到远程仓库。当用户输入 `/gitpush` 时触发此技能。功能包括:自动暂存所有更改、自动生成提交信息、自动提交到本地仓库、自动推送到远程分支。成功后报告提交状态、文件数量和耗时。

下载

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 确认输出流向正确文件

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

git github golang 标准库

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

539

5

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

616

5

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1296

5

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.05

811

5

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.05.21

1906

6

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

5494

18

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2025.06.10

2554

13

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

2025.06.17

4406

17

golang数组大全
golang数组大全

本专题整合了golang数组相关问题解决方法,想了解更多相关内容,请阅读下面的文章。

2025.06.20

5746

22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman Native Git工作流指南
Postman Native Git工作流指南

共0课时 | 0人学习

vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8.2万人学习