Golang 自带log包的简单使用

俗话说的好,流水的代码,铁打的日志。日志是我们在程序出错时能够快速定位错误位置的有力保证!所以说工欲善其事必先利其器!
Go语言自带了一个小小的简便日志包:log,虽说功能不多,但是对于一些不大的项目来说,其实也够用了,与其导入一个功能繁多,但是很多功能用不上的log包,不如使用自带的功能,稳定且不会增加编译后的文件大小。并且log包是线程安全的,也就是说你完全可以放心的在多个goroutine中使用,而不用有任何的担心。
使用log包打印日志有两种开启方式:
1.直接使用log包为我们封装好的方法
2.初始化一个Logger对象
两种方法都有一个共同点,就是不管我们用哪一种方法,都需要设置日志文件输出的路径文件(好像是句废话。。)。
我们先来说第一种方式的使用:

1.1设置输出文件

log.SetOutput(outfile)

其中outfile是我们日志文件的地址,如果不设置的话将会直接在控制台打印出来。

1.2设置提示信息

一般信息输出到日志文件中时,我们需要知道当时发生的时间,地点等等。

log.SetFlags(log.LstdFlags | log.Lshortfile)

flags标识了当前信息需要展示的额外记录,golang为我们提供了下面这几种标识:

const (
    Ldate         = 1 << [iota](https://golang.org/pkg/builtin/#iota)     // the date in the local time zone: 2009/01/23
    Ltime                         // the time in the local time zone: 01:23:23
    Lmicroseconds                 // microsecond resolution: 01:23:23.123123\.  assumes Ltime.
    Llongfile                     // full file name and line number: /a/b/c/d.go:23
    Lshortfile                    // final file name element and line number: d.go:23\. overrides Llongfile
    LUTC                          // if Ldate or Ltime is set, use UTC rather than the local time zone
    Lmsgprefix                    // move the "prefix" from the beginning of the line to before the message
    LstdFlags     = [Ldate](https://golang.org/pkg/log/#Ldate) | [Ltime](https://golang.org/pkg/log/#Ltime) // initial values for the standard logger
)

需要显示哪几种直接设置到SetFlags()方法里面,一般显示时间直接使用LstdFlags常量,它表示已年月日 时分秒的格式显示出来。
有时候,我们可能需要标识某条日志记录的重要程度,类似于在每条的日志前面显示:[warning] [error]等等,这种消息我们只需要调用 :

log.SetPrefix("[warning]")

方法里面的字符串可以是任意值,它会显示在每行日志的最前面,类似于:
[warning]2020/04/14 16:14:31 Tlog.go:18: 打印个日志
我们在打印日志的时候可以调用如下方法:

func Fatal(v ...interface{})

func Fatalf(format string, v ...interface{})

func Fatalln(v ...interface{})

func Panic(v ...interface{})

func Panicf(format string, v ...interface{})

func Panicln(v ...interface{})

func Prefix() string

func Print(v ...interface{})

func Printf(format string, v ...interface{})

func Println(v ...interface{})


其中,带有Fatal的都会中断程序,例如:log.Fatal()表示同时调用了print跟os.Exit(1),可以看下源码:

func Fatal(v ...interface{}) {
    std.Output(2, fmt.Sprint(v...))
    os.Exit(1)
}

同样带有Panic的表示同时调用了一个普通的带有Print字段的打印方法跟os.Exit(1)中端方法。到底用哪个则要看实际需求。

2.1初始化Logger

除了上面那一种直接使用的方式之外,还有初始化Logger的这种方式。

logger := log.New(outfile, "[error]", log.LstdFlags|log.Lshortfile)

New方法的参数介绍:

func New(out io.Writer, prefix string, flag int) *Logger {
    .......
}

out io.Writer:可以是任意一个实现了io.Writer接口的对象
prefix: 就是我们第一种方法里面显示[warning]的提示信息
flag:是显示时间,地点的标识
初始化Logger之后,剩下的则是调用打印方法打印Log,能够调用的打印方法则跟第一种方法里面的相同。
共勉!

你可能感兴趣的:(Golang 自带log包的简单使用)