2025 年 Golang 日志库综述

译文 2025-11-27 11:12:23

在Golang中，日志记录是软件开发的一个重要方面，因为它能帮助开发人员监控、排查故障并分析应用程序的行为。

标准库 log

Go 的标准库包含一个名为 log 的基本日志包。它提供了一种向控制台记录消息的简单方法：

package main

import (
    "log"
)

func main() {
    log.Println("This is a log message")
}

然而，标准的log包比较简约，可能不适用于更复杂的日志记录需求，例如日志轮转、日志级别或日志格式化。

标准库 slog

最近，Go 标准库引入了一个名为 slog 的新日志包，为标准库带来了结构化日志功能。结构化日志采用键值对形式，因此可以快速且可靠地进行解析、过滤、搜索和分析。

与 log 包相比，slog 包提供了更高级的日志功能，建议在生产环境中使用。

以下是在Go中使用slog包进行日志记录的示例：

package main

import (
    "os"
    "log/slog"
)

func main() {
    textHandler := slog.NewTextHandler(os.Stdout)
    logger := slog.New(textHandler)

    logger.Info("Usage Statistics",
        slog.Int("current-memory", 50),
        slog.Int("min-memory", 20),
        slog.Int("max-memory", 80),
        slog.Int("cpu", 10),
        slog.String("app-version", "v0.0.1-beta"),
    )
}

要在Go中使用slog包将日志记录到文件，可以使用slog.NewJSONHandler函数创建一个新的处理器，以JSON格式将日志写入文件。以下是一个示例：

package main

import (
    "os"
    "log/slog"
)

func main() {
    file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        panic(err)
    }
    defer file.Close()

    jsonHandler := slog.NewJSONHandler(file)
    logger := slog.New(jsonHandler)

    logger.Info("Application started",
        slog.String("app-version", "v0.0.1-beta"),
    )
}

Logrus

为了满足更高级的日志记录需求，许多开发者会转而使用第三方日志记录库。一个受欢迎的选择是“logrus”，它提供了功能更丰富的日志记录体验。你可以通过以下方式安装它：

go get github.com/sirupsen/logrus

以下是如何使用Logrus库的示例：

package main

import (
    "github.com/sirupsen/logrus"
)

func main() {
    // Create a new logger instance
    log := logrus.New()

    // Set the log level (optional)
    log.SetLevel(logrus.InfoLevel)

    // Log messages
    log.WithFields(logrus.Fields{
        "animal": "walrus",
    }).Info("A walrus appears")
}

Logrus 提供了诸如结构化日志、日志级别、自定义格式化器等功能。

Zap

Go 生态系统中另一个流行的日志库是 Zap，它以高性能和结构化日志功能而闻名。你可以使用以下命令安装它：

go get go.uber.org/zap

以下是如何使用 Zap 库的示例：

package main

import (
    "go.uber.org/zap"
)

func main() {
    // Create a logger
    logger, _ := zap.NewProduction()

    // Log messages
    logger.Info("This is an info message", zap.String("key", "value"))
}

Zap支持高效日志记录，内存分配少，且具有丰富的功能。

Zerolog

Zerolog 是一款快速且简洁的结构化日志工具。它专注于减少内存分配，并为结构化日志记录提供简洁的应用程序接口（API）。无论是基础还是高级的日志记录需求，它都能满足。

你可以通过以下方式安装 Zerolog：

go get github.com/rs/zerolog

以下是如何使用 Zerolog 库的示例：

package main

import (
    "os"
    "github.com/rs/zerolog"
)

func main() {
    // Create a new logger instance
    logger := zerolog.New(os.Stdout).With().Timestamp().Logger()

    // Log messages
    logger.Info().Str("key", "value").Msg("This is an info message")
    logger.Error().Err(fmt.Errorf("An error occurred")).Msg("This is an error message")
}