go語言中的log 包示例詳解

更新時間：2024年11月12日 10:31:12 作者：半桶水專家

Go語言的log包提供了用于記錄日志的基本功能,相比fmt包,增加了時間戳、日志級別等日志管理功能,非常適合用于調(diào)試和記錄運行信息,本文呢介紹go語言中的log 包,感興趣的朋友一起看看吧

1. log包的基礎(chǔ)功能

log包中包含一系列函數(shù)，可以用于打印帶時間戳的日志信息，默認(rèn)將日志寫入標(biāo)準(zhǔn)錯誤輸出（os.Stderr），并在每條日志的開頭添加時間戳。

常用函數(shù)

log.Print：基本日志輸出函數(shù)，類似于fmt.Print，但會在輸出前添加時間戳。

log.Println：類似于fmt.Println，會在輸出前添加時間戳，并在結(jié)尾添加換行符。

log.Printf：類似于fmt.Printf，支持格式化輸出，并在輸出前添加時間戳。

示例代碼：

package main
import "log"
func main() {
    log.Print("This is a log message.")
    log.Println("This is another log message.")
    log.Printf("Formatted log: %d + %d = %d", 2, 3, 2+3)
}

2. log包的日志級別函數(shù)

log包還提供了兩種特殊的日志函數(shù)，用于處理錯誤和程序退出的情況：

log.Fatal：用于記錄嚴(yán)重的錯誤信息，輸出日志后會調(diào)用os.Exit(1)，終止程序執(zhí)行。

log.Panic：用于記錄錯誤信息，同時調(diào)用panic，引發(fā)恐慌（程序崩潰并拋出堆棧信息），適合用于調(diào)試和處理非正常情況。

示例代碼：

package main
import "log"
func main() {
    log.Print("This is a normal log.")
    log.Fatal("This is a fatal error log, program will exit.")  // 輸出后程序會退出
    log.Panic("This will not be executed because of Fatal above.")
}

3. 自定義日志輸出位置

log包默認(rèn)將日志輸出到標(biāo)準(zhǔn)錯誤流（os.Stderr），但是可以通過log.SetOutput方法自定義輸出位置?？梢詫⑷罩据敵龅轿募?、網(wǎng)絡(luò)或其他符合io.Writer接口的目標(biāo)。

示例：將日志輸出到文件

package main
import (
    "log"
    "os"
)
func main() {
    file, err := os.Create("app.log")
    if err != nil {
        log.Fatal("Failed to create log file:", err)
    }
    defer file.Close()
    log.SetOutput(file)  // 將日志輸出設(shè)置為文件
    log.Println("This log will be written to app.log file.")
}

4. 自定義日志前綴和標(biāo)記

log包允許自定義日志的前綴和格式，幫助識別日志的來源或類型。使用log.SetPrefix方法可以設(shè)置日志的前綴，使用log.SetFlags可以控制日志的標(biāo)記。

日志標(biāo)記

log包提供了以下幾個標(biāo)記（使用SetFlags設(shè)置）：

log.Ldate：日期（yyyy/mm/dd）。
log.Ltime：時間（hh:mm）。
log.Lmicroseconds：微秒級時間。
log.Llongfile：完整文件路徑和行號。
log.Lshortfile：簡短文件名和行號。
log.LUTC：使用UTC時間。
log.LstdFlags：默認(rèn)標(biāo)記，等價于log.Ldate | log.Ltime。

示例：自定義日志前綴和標(biāo)記

package main
import "log"
func main() {
    log.SetPrefix("INFO: ")                  // 設(shè)置日志前綴
    log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)  // 設(shè)置日志標(biāo)記
    log.Println("This is a customized log message.")
}

5. 創(chuàng)建自定義的日志記錄器

使用log.New可以創(chuàng)建自定義的日志記錄器（Logger），并指定不同的輸出目標(biāo)、前綴和標(biāo)記。多個日志記錄器可以記錄不同類型的日志信息。

示例：創(chuàng)建兩個不同的日志記錄器

package main
import (
    "log"
    "os"
)
func main() {
    // 創(chuàng)建錯誤日志記錄器，輸出到標(biāo)準(zhǔn)錯誤
    errorLogger := log.New(os.Stderr, "ERROR: ", log.Ldate|log.Ltime|log.Lshortfile)
    // 創(chuàng)建信息日志記錄器，輸出到文件
    infoFile, err := os.Create("info.log")
    if err != nil {
        log.Fatal(err)
    }
    defer infoFile.Close()
    infoLogger := log.New(infoFile, "INFO: ", log.Ldate|log.Ltime)
    infoLogger.Println("This is an informational message.")
    errorLogger.Println("This is an error message.")
}

log包與fmt包的區(qū)別

用途不同：

fmt包主要用于格式化輸入和輸出，適合輸出一般信息，不具備日志管理功能。
log包專為日志設(shè)計，提供日志記錄功能，適合程序中的重要信息、錯誤、調(diào)試信息等的輸出。

輸出內(nèi)容不同：

fmt包輸出沒有時間戳，默認(rèn)不包含額外信息。
log包輸出包含時間戳，且可以設(shè)置額外的標(biāo)記和前綴。

輸出位置：

fmt包的輸出目標(biāo)默認(rèn)為標(biāo)準(zhǔn)輸出（os.Stdout），可以通過fmt.Fprint將輸出定向到指定目標(biāo)。
log包的默認(rèn)輸出為標(biāo)準(zhǔn)錯誤（os.Stderr），且可以通過log.SetOutput輕松修改輸出目標(biāo)。

日志級別：