golang写日志教程

开发过程中，日志是一个必不可少的工具，它记录了程序的运行情况，有助于我们定位和解决问题。在Go语言中，有很多强大的日志库可以使用，本文将介绍一种常用的方式来使用日志库。

概述

Go语言的日志库有很多，比如log包、logrus等，它们提供了丰富的接口和功能，可以满足不同场景的需求。其中，logrus是一种功能强大、使用方便的日志库，被广泛应用于Go语言开发中。下面，我们将详细介绍如何使用logrus来记录日志。

安装logrus

在开始之前，我们需要先安装logrus这个日志库。打开终端，执行以下命令即可完成安装：

go get github.com/sirupsen/logrus

安装完成后，我们可以在项目中引入logrus包来使用它的功能。

基本用法

使用logrus记录日志非常简单。我们只需要导入logrus包，并创建一个logrus.Logger的实例，就可以使用该实例记录日志了。

首先，我们需要导入logrus包：

import log "github.com/sirupsen/logrus"

接下来，我们创建一个logrus.Logger的实例：

logger := log.New()

通过这个logger实例，我们可以使用logrus库提供的各种方法来记录日志。例如，使用Println方法记录一条普通日志：

logger.Println("This is a normal log message")

当然，我们也可以使用其他方法来记录不同级别的日志，比如Debug、Info、Warn、Error等。根据实际需要选择合适的方法即可：

logger.Debug("This is a debug log message")
logger.Info("This is an info log message")
logger.Warn("This is a warning log message")
logger.Error("This is an error log message")

配置日志格式

除了记录不同级别的日志外，logrus还支持自定义日志格式。我们可以通过配置Formatter来定制日志的输出格式。

logrus提供了两种默认的Formatter：TextFormatter和JSONFormatter。它们分别用于按可读文本和JSON格式输出日志。

下面是一个使用TextFormatter输出可读文本格式日志的示例：

logger.SetFormatter(&log.TextFormatter{
    DisableColors: true, // 禁用控制台样式的颜色输出
    TimestampFormat: "2006-01-02 15:04:05", // 时间格式
})

设置完Formatter后，我们就可以按照指定的格式记录日志了：

logger.Info("This is an info log message with custom format")

类似地，我们也可以使用JSONFormatter来输出JSON格式日志：

logger.SetFormatter(&log.JSONFormatter{})
logger.Info("This is an info log message with JSON format")

通过配置Formatter，我们可以灵活地调整日志的输出格式，以满足不同的需求。

日志输出至文件

除了输出到控制台，我们还可以将日志记录到文件中。logrus提供了一个RotatingFileHook，用于实现日志的轮转和切割。

首先，我们需要导入logrus的lumberjack包：

import "gopkg.in/natefinch/lumberjack.v2"

然后，我们创建一个RotatingFileHook并将其添加到logger的Hooks中：

hook := lumberjack.Logger{
    Filename:   "logs/app.log", // 日志文件路径
    MaxSize:    50, // 单个日志文件的最大大小（MB）
    MaxBackups: 3, // 最多保留的旧日志文件数
    MaxAge:     7, // 日志文件保留的天数
    Compress:   true, // 是否压缩旧日志文件
}
logger.AddHook(&logrus_hooks.RotatingFileHook{
    Writer:       &hook,
    RotationTime: time.Duration(24) * time.Hour, // 切割日志的时间间隔
})

配置完毕后，我们就可以将日志输出到指定的文件中了。同时，logrus会根据配置的规则对日志进行切割和轮转，保持日志文件的大小和数量在可控范围内。

总结

通过本文的介绍，我们了解了如何使用logrus这个强大的日志库来记录Go语言程序的日志。从基本用法到自定义日志格式，再到将日志输出至文件，logrus提供了丰富的功能和灵活的配置，可以满足不同场景下的需求。

当然，除了logrus，还有很多其他优秀的日志库可供选择。根据项目的实际情况和个人偏好，选择合适的日志库是非常重要的。希望本文对你学习和使用Go语言的日志库有所帮助！