替代Zap，Go語言官方實現的結構化日志包

作者：云原生Go 2024-02-01 13:30:53

無論你是一個初級還是高級的 Go 開發人員，理解和掌控 go 的日志系統是非常有用的。接下來，讓我們深入研究一下 Go 中的日志行為，并通過實例來詳細理解每個主要功能。

在 Go 1.21 中，引入了一個新的 log 包 -- log/slog，這是一個強大的日志記錄庫，提供了許多用于幫助開發人員更加有效地記錄、管理和理解日志的工具。無論你是一個初級還是高級的 Go 開發人員，理解和掌控 go 的日志系統是非常有用的。接下來，讓我們深入研究一下 Go 中的日志行為，并通過實例來詳細理解每個主要功能。

安裝

在 Go 1.21 中，log/slog 是系統自帶的，無需安裝。只需在代碼頂部加上 import "log/slog" 即可使用。

package main

import "log/slog"

初始化

在 Go 1.21 的標準庫中，log/slog 的初始化非常直觀。以下是一個簡單初始化示例：

package main

import "log/slog"

func main() {
    log := slog.New()
}

這將創建一個新的公共日志記錄器，此記錄器具有默認的日志級別（ERROR），但您可以使用 SetLevel 方法來修改這個級別。

設置日志級別

log/slog 提供了設置日志級別的方法。包括：DEBUG，INFO，WARNING，ERROR，FATAL。以下為設置日志級別的示例：

package main

import "log/slog"

func main() {
    log := slog.New()
    log.SetLevel(slog.DEBUG)
}

在這里，我們把默認的日志級別從 ERROR 設置為 DEBUG。

日志輸出

package main

import "log/slog"

func main() {
    log := slog.New()
    log.SetLevel(slog.DEBUG)

    log.Debug("this is a debug message")
    log.Info("this is an info message")
    log.Warning("this is a warning message")
    log.Error("this is an error message")
}

以上代碼，我們會看到所有的信息都會被打印出來。因為我們把日志等級設置成了 DEBUG, 這是最低級別的，所以所有的日志信息都會被打印出來。

自定義日志格式

log/slog 提供了 Formatter 接口，允許你自定義日志的格式。你可以通過實現這個接口，創建自己的 Formatter。

package main

import (
    "log/slog"
    "os"
    "time"
)

type MyFormatter struct{}

func (f *MyFormatter) Format(entry *slog.Entry) ([]byte, error) {
    return []byte(fmt.Sprintf("%s [%s] %s\n", entry.Time.Format(time.RFC3339), entry.Level.String(), entry.Message), nil
}

func main() {
    log := slog.New()

    log.SetFormatter(&MyFormatter{})
    log.SetLevel(slog.DEBUG)
    log.SetOutput(os.Stdout)

    log.Debug("this is a debug message")
    log.Info("this is an info message")
    log.Warning("this is a warning message")
    log.Error("this is an error message")
}

以上是自定義日志格式的示例，我們創建了一個新的 Formatter, 將日志格式設置為 [時間] [級別] 信息。

結語

以上就是 Go 1.21 標準庫 log/slog 的基本介紹和使用方法。希望這篇文章能幫助你更好地理解和使用 Go 的日志系統，高效地處理你的日志任務。

責任編輯：武曉燕來源：源自開發者

Go 語言開發