快捷導(dǎo)航

go語(yǔ)言中的log 包示例詳解

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

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

Go語(yǔ)言的log包提供了用于記錄日志的基本功能。相比fmt包，log包增加了時(shí)間戳、日志級(jí)別等日志管理功能，非常適合用于調(diào)試和記錄運(yùn)行信息。下面是對(duì)log包的詳細(xì)說(shuō)明，以及它與fmt包的區(qū)別。

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

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

常用函數(shù)

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

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

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

示例代碼：

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包的日志級(jí)別函數(shù)

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

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

log.Panic：用于記錄錯(cuò)誤信息，同時(shí)調(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.")  // 輸出后程序會(huì)退出
    log.Panic("This will not be executed because of Fatal above.")
}

3. 自定義日志輸出位置

log包默認(rèn)將日志輸出到標(biāo)準(zhǔn)錯(cuò)誤流（os.Stderr），但是可以通過(guò)log.SetOutput方法自定義輸出位置?？梢詫⑷罩据敵龅轿募⒕W(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包允許自定義日志的前綴和格式，幫助識(shí)別日志的來(lái)源或類型。使用log.SetPrefix方法可以設(shè)置日志的前綴，使用log.SetFlags可以控制日志的標(biāo)記。

日志標(biāo)記

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

log.Ldate：日期（yyyy/mm/dd）。
log.Ltime：時(shí)間（hh:mm）。
log.Lmicroseconds：微秒級(jí)時(shí)間。
log.Llongfile：完整文件路徑和行號(hào)。
log.Lshortfile：簡(jiǎn)短文件名和行號(hào)。
log.LUTC：使用UTC時(shí)間。
log.LstdFlags：默認(rèn)標(biāo)記，等價(jià)于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)記。多個(gè)日志記錄器可以記錄不同類型的日志信息。

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

package main
import (
    "log"
    "os"
)
func main() {
    // 創(chuàng)建錯(cuò)誤日志記錄器，輸出到標(biāo)準(zhǔn)錯(cuò)誤
    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è)計(jì)，提供日志記錄功能，適合程序中的重要信息、錯(cuò)誤、調(diào)試信息等的輸出。

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

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

輸出位置：

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

日志級(jí)別：