Golang日志记录实现与库配置方法

在Go项目中实现日志记录功能有多种方案，具体选择取决于项目需求。对于小型项目或快速开发，可使用标准库log，它简单易用但不支持日志级别和灵活配置；若需要结构化日志和分级输出，推荐使用logrus，它支持JSON格式、日志级别设置及输出到文件或远程服务器；对性能要求较高的高并发项目可选用zap，其写入速度快，支持结构化字段和标准化输出；若追求轻量级结构化日志，则可尝试zerolog。无论选择哪种方案，都建议统一封装日志调用方式以便后期维护和替换。

在 Go 项目中实现日志记录功能，其实并不复杂。Go 标准库自带了 log 包，可以满足基础的日志需求。但如果你需要更丰富的功能，比如分级日志、输出到文件、支持 JSON 格式等，就需要引入第三方日志库，比如 logrus、zap 或 zerolog。

下面我们就来看看几种常见的做法，帮助你根据实际场景选择合适的日志方案。

使用标准库 log 实现基础日志记录

Go 自带的 log 包使用简单，适合小型项目或者快速开发。

package main

import (
    "log"
    "os"
)

func main() {
    // 输出到控制台
    log.Println("这是一条普通日志")

    // 输出到文件
    file, _ := os.Create("app.log")
    log.SetOutput(file)
    log.Println("这条日志会被写入文件")
}

优点：

• 不需要额外依赖
• 简单易用

缺点：

• 不支持日志级别（info/warn/error）
• 无法灵活配置输出格式和路径

如果只是调试或轻量级服务，直接用标准库就够了。但一旦项目变大，还是建议换更强大的日志库。

用 logrus 实现结构化日志

logrus 是一个非常流行的日志库，支持结构化日志、多级输出等特性。

安装方式：

go get github.com/sirupsen/logrus

基本用法示例：

package main

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

func main() {
    // 设置日志格式为 JSON，默认是 text
    log.SetFormatter(&log.JSONFormatter{})

    // 记录不同级别的日志
    log.WithFields(log.Fields{
        "animal": "walrus",
    }).Info("信息日志")

    log.Warn("警告信息")

    log.Error("错误信息")
}

常用配置点：

• 日志级别设置：log.SetLevel(log.DebugLevel)
• 输出到文件：log.SetOutput(os.Stderr)
• 支持 hook，可将日志发送到远程服务器

logrus 的优势在于它既保持了简洁性，又提供了不错的扩展能力，适合大多数中型项目。

高性能日志 zap 的使用技巧

如果你对性能要求较高，比如高并发服务、微服务，那么 zap 是个不错的选择。它由 Uber 开发，专为高性能设计。

安装方式：

go get go.uber.org/zap

基本使用：

package main

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

func main() {
    logger, _ := zap.NewProduction()
    defer logger.Sync()

    logger.Info("这是一个 info 日志",
        zap.String("method", "GET"),
        zap.Int("status", 200),
    )
}

特点：

• 极快的写入速度
• 支持结构化日志字段
• 提供 SugaredLogger 接口，便于过渡使用
• 默认输出 JSON 格式

不过 zap 的学习成本略高于 logrus，API 设计也更偏向“严谨”，更适合追求性能和标准化输出的项目。

如何选择适合你的日志库？

• 项目小、不需要复杂功能？ → 用标准库 log
• 需要结构化日志 + 分级输出？ → 用 logrus
• 追求极致性能 + 高并发？ → 用 zap
• 想要最轻量结构化？ → 可以试试 zerolog

选好之后，记得统一封装一下日志调用方式，方便后期替换或者统一处理。比如定义一个 logger 接口，在多个模块中注入使用。

基本上就这些。日志虽然看起来简单，但合理配置后能大大提升排查问题的效率，别等到出问题才想起来加日志。