Go 入门很简单(如何在 Go 中使用日志包)

寸阳分阴须爱惜,休负春色与时光。这篇文章主要讲述Go 入门很简单:如何在 Go 中使用日志包相关的知识,希望能为你提供帮助。

引言在我们的日常编程中,日志很重要。只要是我们写代码,就有可能出现 Bug。日志文件就是一种快速找到这些 bug,更好地了解程序工作状态的方法。
让我们来看一下日志文件的定义:
日志文件是记录操作系统或其他软件运行中发生的事件或通信软件的不同用户之间的消息的文件。记录是保存日志的行为。
日志是开发人员的眼睛和耳朵,可以用来跟踪、定位错误、调试和分析代码,并监控应用程序的性能。在最简单的情况下,消息被写入单个日志文件。
Go 语言标准库之log 包【Go 入门很简单(如何在 Go 中使用日志包)】正因为日志很重要,所以 Go 语言标准库提供了 ??log?? 包,可以对日志做一些简单的配置,我们可以定制一套自己的日志记录器。
Golang 中的 ??log?? 包实现了简单的 logging 包。它定义了一个类型、Logger 以及格式化输出的方法。 它还具有预定义的“标准”记录器,可通过辅助函数 ??Print[f|ln]??、??Fatal[f|ln]?? 和 ??Panic[f|ln]?? 访问,它们比手动创建记录器更易于使用。
基本的日志项包括:前缀、日期时间戳、该日志由哪个源文件记录的、源文件记录日志所在行,最后是日志消息。让我们来看一下简单的使用 ??log?? 包:在除法运算时除 0 时的消息返回程序,而不是直接退出程序。

package main

import (
"errors"
"fmt"
"log"
)

func myDiv(x float64, y float64) (float64, error)

if y == 0
return 0, errors.New("被除数不能为0")


return x / y, nil


func main()

var x float64 = 128.2
var y float64

res, err := myDiv(x, y)

if err != nil
log.Print(err) // Print 写到标准日志记录器


fmt.Println(res)

运行该程序:
$ go run learninglog.go
2022/04/19 23:18:06 被除数不能为0
0

在上面的程序中,我们导入了三个包:??errors?? 、??fmt??、??log?? 。
然后使用了 ??log?? 包中的 ??Print?? 函数:此时日志记录器将写入标准错误并打印每条记录消息的日期和时间,这在一般情况下非常有用。每条日志消息在单独的行上都有一个输出:如果正在打印的消息没有在新行结束,记录器将添加一行。
另外,??log?? 包中的 ??Fatal?? 函数在写入日志消息后调用 ??os.Exit(1)??。
func main()

var x float64 = 128.2
var y float64

res, err := myDiv(x, y)

if err != nil
log.Fatal(err) // 在调用 Print() 之后会接着调用 os.Exit(1)


fmt.Println(res)


// 2022/04/19 23:22:44 被除数不能为0
// exit status 1

而 ??Panic?? 函数在写入日志消息后调用 ??panic??,除非程序执行 ??recover()?? 函数,否则会导致程序打印调用栈后终止。
func main()

var x float64 = 128.2
var y float64

res, err := myDiv(x, y)

if err != nil
log.Panic(err)// Panic 会在调用 Print() 之后接着用 panic()


fmt.Println(res)

运行结果:
2022/04/19 23:24:18 被除数不能为0
panic: 被除数不能为0

goroutine 1 [running]:
log.Panic(0xc000086f60?, 0xc000086f70?, 0x404f99?)
/usr/local/go/src/log/log.go:385 +0x65
main.main()
/home/wade/go/src/logLearning/learninglog.go:26 +0x65
exit status 2

由此可知,??Print?? 系列函数才是写日志消息的标准方法。
如何将日志消息存储在 Go 中的文件中上述代码中,只是简单把日志消息打印到控制台,这是远远不够的,因为控制台是实时的,如果关闭控制台日志消息也就关闭了。
鉴于我们已经学习了 Go 语言如何读取文件,所以就可以把日志消息存储到一个文件中,把所有的日志存储到该文件中。
package main

import (
"errors"
"fmt"
"log"
"os"
)

func myDiv(x float64, y float64) (float64, error)

if y == 0
return 0, errors.New("被除数不能为0")


return x / y, nil


func main()

var x float64 = 128.2
var y float64

res, exception := myDiv(x, y)

file, err := os.OpenFile("info.log", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0600)

if err != nil
log.Fatal(err)


defer file.Close()// 关闭文件

log.SetOutput(file)
log.Print(exception)
fmt.Println(res)

运行代码:
$ go run learninglog.go
0

此外,我们会发现目录中多了一个创建的 ??info.log?? 文件。打开文件,你会看到打印出类似下面的内容。

定制你的日志记录器要想创建一个定制的日志记录器,我们需要创建一个 ??Logger?? 类型的结构体,然后给每个日志记录器配置一个输出目的地、前缀和标志。而且每一个日志记录器是多 goroutine 安全的,每一个 ??Logger?? 结构体都有一个互斥锁,意味着多个 goroutine 可以同时调用来自同一个日志记录器的这些函数,而不会有彼此间的写冲突。来看一下 ??Logger?? 结构体的底层实现:
Logger结构体
// A Logger represents an active logging object that generates lines of
// output to an io.Writer. Each logging operation makes a single call to
// the Writers Write method. A Logger can be used simultaneously from
// multiple goroutines; it guarantees to serialize access to the Writer.
type Logger struct
musync.Mutex // ensures atomic writes; protects the following fields
prefix string// prefix on each line to identify the logger (but see Lmsgprefix)
flagint// properties
outio.Writer// destination for output
buf[]byte// for accumulating text to write

然后我们来看一个示例程序:
package main

import (
"io"
"io/ioutil"
"log"
"os"
)

var (
Trace*log.Logger // 记录所有日志
Info*log.Logger // 重要的信息
Warning *log.Logger // 警告信息
Error*log.Logger // 错误信息
)

func init()
file, err := os.OpenFile("errors.txt", os.O_CREATE|os.O_WRONLY|os

    推荐阅读