Golang log库日志记录与格式化输出

P粉602998670

发布时间：2025-09-03 09:07:01

471人浏览过

来源于php中文网

原创

选择日志库需根据项目规模、性能需求和团队熟悉度：小型项目用标准库log，中型项目选logrus，大型高并发项目用zap；logrus可通过实现Formatter接口自定义格式，如添加时间戳、文件名、行号等提升可读性；日志可输出到多目的地，使用io.MultiWriter同时写入文件和控制台，或通过网络发送至远程服务器；生产环境中应设置合理日志级别、启用日志轮转（如lumberjack）、压缩日志文件、监控磁盘使用，并将日志发送至ELK等远程系统以防磁盘耗尽。

golang log库日志记录与格式化输出

日志记录和格式化输出在任何Golang应用中都至关重要，它们帮助我们诊断问题、追踪应用行为。Golang标准库提供了

log

包，但它功能相对简单。因此，许多开发者会选择更强大的第三方库，如

logrus

或

zap

。

日志记录的关键在于选择合适的库，配置好输出格式，以及确保在代码中正确地使用日志记录功能。

解决方案：

选择合适的日志库：

log

、

logrus

、

zap

各有所长。

log

简单易用，适合小型项目或快速原型开发。

logrus

提供结构化日志、不同日志级别、可扩展性，适合中型项目。

zap

性能极高，尤其适合对性能要求苛刻的大型项目。

立即学习“go语言免费学习笔记（深入）”；

配置日志格式：无论选择哪个库，配置日志格式都非常重要。

log

库只能简单地设置前缀和一些flag。

logrus

和

zap

则允许自定义formatter，将日志输出为JSON、文本或其他格式。JSON格式更易于机器解析，方便日志分析工具处理。

正确使用日志级别：日志级别包括Debug、Info、Warning、Error、Fatal等。Debug级别用于开发阶段的详细信息，Info级别用于记录正常运行时的关键事件，Warning级别用于记录潜在的问题，Error级别用于记录错误，Fatal级别用于记录导致程序崩溃的错误。

代码示例（使用

logrus

）：

package main

import (
    "fmt"
    "os"

    "github.com/sirupsen/logrus"
)

var log = logrus.New()

func main() {
    // 设置日志格式为JSON
    log.SetFormatter(&logrus.JSONFormatter{})

    // 设置日志输出到文件
    file, err := os.OpenFile("application.log", os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0666)
    if err != nil {
        fmt.Println("Failed to open log file:", err)
        os.Exit(1)
    }
    defer file.Close()
    log.SetOutput(file)

    // 设置日志级别
    log.SetLevel(logrus.InfoLevel)

    // 记录日志
    log.WithFields(logrus.Fields{
        "animal": "walrus",
        "size":   10,
    }).Info("A group of walrus emerges from the ocean")

    log.Warn("Disk is almost full")

    log.WithFields(logrus.Fields{
        "omg":    true,
        "number": 122,
    }).Error("The group's number increased tremendously!")

    // 可以考虑在特定情况下使用panic，但要谨慎
    // log.Panic("I'm bailing.")

    // 也可以使用Fatal，但它会调用os.Exit(1)
    // log.Fatal("Terminating the application")
}

如何选择最适合我的Golang项目的日志库？