俗话说的好,流水的代码,铁打的日志。日志是我们在程序出错时能够快速定位错误位置的有力保证!所以说工欲善其事必先利其器!
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,能够调用的打印方法则跟第一种方法里面的相同。
共勉!