golang標(biāo)準(zhǔn)庫log包的學(xué)習(xí)使用

更新時(shí)間：2025年11月21日 09:38:29 作者：PPPsych

本文詳細(xì)介紹了Go語言的標(biāo)準(zhǔn)庫log,包括log的基本使用、 Panic和Fatal系列函數(shù)、標(biāo)準(zhǔn)日志配置、日志前綴設(shè)置、日志輸出位置調(diào)整以及如何自定義logger,感興趣的可以了解一下

一 log簡介

golang內(nèi)置了log包，實(shí)現(xiàn)簡單的日志服務(wù)。通過調(diào)用log包的函數(shù)，可以實(shí)現(xiàn)簡單的日志打印功能。

二 log簡單使用

log包中有3個(gè)系列的日志打印函數(shù)，分別print系列、panic系列、fatal系列.

函數(shù)系列	說明	作用
Print	Print/Printf/Println	單純打印日志
Panic	Panic/Panicf/Panicln	打印日志，拋出panic異常
Fatal	Fatal/Fatalf/Fatalln	打印日志，強(qiáng)制結(jié)束程序(os.Exit(1))，defer函數(shù)不會(huì)執(zhí)行

log包主要提供了3類接口，分別是print系列、panic系列、fatal系列，對每一類接口其提供了3種調(diào)用方式，分別是“Xxxx、Xxxxln、Xxxxf”，基本與fmt中的相關(guān)函數(shù)類似。

2.1 log.Print/Println/Printf函數(shù)

log.Print/Println/Printf函數(shù)只是單純打印日志

實(shí)例演示：

package main

import "log"

func main() {
	log.Print("my log")
	log.Printf("my log %d", 100) // 格式化輸出
	name := "tom"
	age := 20
	log.Println(name, " ", age)

}

運(yùn)行結(jié)果：

[Running] go run "c:\Users\Mechrevo\Desktop\go_pro\test.go"
2022/07/12 17:27:16 my log
2022/07/12 17:27:16 my log 100
2022/07/12 17:27:16 tom 20

[Done] exited with code=0 in 1.118 seconds

基本使用與fmt中的函數(shù)類似

2.2 log.Panic/Panicf/Panicln函數(shù)

log.Panic/Panicf/Panicln函數(shù)會(huì)打印出日志并且拋出panic異常，需要注意的是在panic之后聲明的代碼將不會(huì)執(zhí)行。

實(shí)例演示：

package main

import (
	"fmt"
	"log"
)

func main() {
	defer fmt.Println("發(fā)生了 panic錯(cuò)誤！")
	log.Print("my log")
	log.Panic("my panic")
	fmt.Println("運(yùn)行結(jié)束。。。")
}

運(yùn)行結(jié)果：

[Running] go run "c:\Users\Mechrevo\Desktop\go_pro\test.go"
2022/07/12 17:31:48 my log
2022/07/12 17:31:48 my panic
發(fā)生了 panic錯(cuò)誤！
panic: my panic

goroutine 1 [running]:
log.Panic({0xc00007ff30?, 0x60?, 0x6e7be0?})
c:/go/src/log/log.go:385 +0x65
main.main()
c:/Users/Mechrevo/Desktop/go_pro/test.go:11 +0xc5
exit status 2

[Done] exited with code=1 in 1.013 seconds

可見輸出了log.Print和log.Panic中的內(nèi)容，然后再panic之前的defer函數(shù)被調(diào)用并輸出，而log.Panic之后的fmt.Println并沒有被調(diào)用輸出，可見log.Panic拋出panic異常之后的代碼是不會(huì)被調(diào)用的。

log.Panicf/Panicln用法與2.1中的Println/Printf函數(shù)類似，此處不再贅述。

2.3 log.Fatal/Fatalf/Fatalln函數(shù)

對于log.Fatal接口，會(huì)將日志內(nèi)容打印輸出，接著調(diào)用系統(tǒng)的os.Exit(1)接口，強(qiáng)制退出程序并返回狀態(tài)1，但是有一點(diǎn)需要注意的是，由于直接調(diào)用系統(tǒng)os接口退出，defer函數(shù)不會(huì)調(diào)用。

實(shí)例演示：

package main

import (
	"fmt"
	"log"
)

func main() {
	defer fmt.Println("defer。。。")
	log.Print("my log")
	log.Fatal("my fatal")
	fmt.Println("運(yùn)行結(jié)束。。。")
}

運(yùn)行結(jié)果：

[Running] go run "c:\Users\Mechrevo\Desktop\go_pro\test.go"
2022/07/12 17:40:04 my log
2022/07/12 17:40:04 my fatal
exit status 1

[Done] exited with code=1 in 0.975 seconds

可見并沒有調(diào)用defer函數(shù)。

log.Fatalf/Fatalln用法與2.1中的Println/Printf函數(shù)類似，此處不再贅述。

三標(biāo)準(zhǔn)日志配置

默認(rèn)情況下log只會(huì)打印出時(shí)間，但是實(shí)際情況下我們還需要獲取文件名，行號(hào)等信息，log包提供給我們定制的接口。

log包提供兩個(gè)標(biāo)準(zhǔn)log配置的相關(guān)方法：

方法	說明
func Flags() int	返回標(biāo)準(zhǔn)log輸出配置
func SetFlags(flag int)	設(shè)置標(biāo)準(zhǔn)log輸出配置

3.1 flag參數(shù)

const (
    // 控制輸出日志信息的細(xì)節(jié)，不能控制輸出的順序和格式。
    // 輸出的日志在每一項(xiàng)后會(huì)有一個(gè)冒號(hào)分隔，例如2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message
    Ldate         = 1 << iota     // 日期，2009/01/23
    Ltime                         // 時(shí)間，01:23:23
    Lmicroseconds                 // 微秒級(jí)別的時(shí)間，01:23:23.123123（用于增強(qiáng)Ltime位）
    Llongfile                     // 文件全路徑名+行號(hào)，/a/b/c/d.go:23
    Lshortfile                    // 文件名+行號(hào)，d.go:23（會(huì)覆蓋掉Llongfile）
    LUTC                          // 使用UTC時(shí)間
    LstdFlags     = Ldate | Ltime // 標(biāo)準(zhǔn)logger的初始值
)

3.2 標(biāo)準(zhǔn)日志配置示例

package main

import (
	"fmt"
	"log"
)

func main() {
	i := log.Flags()
	fmt.Printf("i: %v\n", i)
	log.SetFlags(log.Ldate | log.Ltime | log.Llongfile)
	log.Print("my log")
}

運(yùn)行結(jié)果：

[Running] go run "c:\Users\Mechrevo\Desktop\go_pro\test.go"
i: 3
2022/07/12 17:59:29 c:/Users/Mechrevo/Desktop/go_pro/test.go:12: my log

[Done] exited with code=0 in 1.102 seconds

四日志前綴配置

log包提供兩個(gè)日志前綴配置的相關(guān)函數(shù)：

方法	說明
func Prefix() string	返回日志的前綴配置
func SetPrefix(prefix string)	設(shè)置日志前綴

實(shí)例演示：

package main

import (
	"fmt"
	"log"
)

func main() {
	s := log.Prefix()
	fmt.Printf("s: %v\n", s)
	log.SetPrefix("[MyLog] ")
	s = log.Prefix()
	fmt.Printf("s: %v\n", s)
	log.Print("my log...")
}

運(yùn)行結(jié)果：

[Running] go run "c:\Users\Mechrevo\Desktop\go_pro\test.go"
s:
s: [MyLog]
[MyLog] 2022/07/12 18:00:55 my log...

[Done] exited with code=0 in 0.977 seconds

五日志輸出位置配置

前面介紹的都是將日志輸出到控制臺(tái)上，golang的log包還支持將日志輸出到文件中，log包提供了func SetOutput(w io.Writer)函數(shù)，將日志輸出到文件中。

實(shí)例演示：

package main

import (
	"log"
	"os"
)

func main() {
	f, err := os.OpenFile("a.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
	if err != nil {
		log.Panic("打開日志文件異常")
	}
	log.SetOutput(f)
	log.Print("my log...")
}

運(yùn)行結(jié)果：

日志輸出到當(dāng)前目錄下 a.log文件中

2022/07/12 18:02:20 my log...

六自定義logger

log包中提供了func New(out io.Writer, prefix string, flag int) *Logger函數(shù)來實(shí)現(xiàn)自定義logger。從效果上來看，就是標(biāo)準(zhǔn)日志配置、日志前綴配置、日志輸出位置配置整合到一個(gè)函數(shù)中，使日志配置不在那么繁瑣。

實(shí)例演示：

package main

import (
	"log"
	"os"
)

var logger *log.Logger

func init() {
	logFile, err := os.OpenFile("a.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
	if err != nil {
		log.Panic("打開日志文件異常")
	}
	logger = log.New(logFile, "[Mylog]", log.Ldate|log.Ltime|log.Lshortfile)
}

func main() {
	logger.Println("自定義logger")
}

運(yùn)行結(jié)果：

日志輸出到當(dāng)前目錄下 a.log文件中

[Mylog]2022/07/12 18:06:21 test.go:19: 自定義logge

到此這篇關(guān)于golang標(biāo)準(zhǔn)庫log包的學(xué)習(xí)使用的文章就介紹到這了,更多相關(guān)golang標(biāo)準(zhǔn)庫log包內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: