当前位置：首页 > 文章列表 > Golang > Go教程 > Golang日志功能添加指南：zap与logrus选择

Golang日志功能添加指南：zap与logrus选择

2026-03-31 16:35:26 0浏览收藏

在 Go 项目中，日志是保障可观测性与快速排障的核心环节，而 zap 和 logrus 作为两大主流日志库，分别以高性能结构化输出和高扩展性易用性见长：zap 由 Uber 开源，适合高并发、低延迟场景，支持精细配置与日志轮转；logrus 社区成熟、API 直观，内置丰富 Hook 和上下文字段能力，更利于新手上手与复杂定制。无论选择哪一者，关键都在于合理使用结构化字段、分级控制日志输出、避免冗余信息——掌握它们，就能为你的 Go 应用打下坚实可靠的日志基石。

zap 和 logrus 是 Golang 中常用的日志库，分别适用于高性能和高扩展性场景。1. zap 由 Uber 开源，适合高并发项目，支持结构化日志、多级别输出，可通过 lumberjack 实现日志轮转；2. logrus 社区活跃，提供丰富功能如 hook、字段添加等，适合需要灵活定制的项目，且 API 更直观易用；3. 选择建议：追求性能优先选 zap，需要功能扩展则选 logrus，新手推荐从 logrus 入门。两者都应合理使用字段、控制日志级别以提升维护效率。

Golang项目如何添加日志功能使用zap或logrus记录日志

在 Golang 项目中添加日志功能，是提升程序可维护性和排查问题效率的重要一步。如果你希望日志系统既高效又灵活，zap 和 logrus 是两个非常流行的选择：zap 更注重性能和结构化日志输出，logrus 则提供了更丰富的功能扩展和友好的 API。

下面分别介绍如何在这两种库中实现基本的日志记录功能，并给出一些实用建议。

使用 zap 添加日志功能

Zap 是 Uber 开源的一个高性能日志库，适合对性能要求较高的项目。它支持结构化日志、多种日志级别（debug、info、warn、error 等），并且可以配置输出到文件或控制台。

使用步骤如下：

安装依赖：

go get -u go.uber.org/zap

初始化 logger 并使用：

package main

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

func main() {
    // 创建默认的生产环境 logger（带调用栈）
    logger, _ := zap.NewProduction()
    defer logger.Sync()

    logger.Info("这是一个 info 日志",
        zap.String("key", "value"),
        zap.Int("count", 1),
    )

    logger.Error("发生了一个错误",
        zap.Error(err), // 假设 err 已定义
    )
}

实用建议：

如果你不需要调用栈信息，可以用 zap.NewExample() 或者自定义配置来减少开销。
对于开发环境，推荐使用 zap.NewDevelopment()，它会输出更易读的格式。
可以结合 lumberjack 实现日志轮转（按大小、时间切割）。

使用 logrus 添加日志功能

Logrus 是一个社区活跃、功能丰富的日志库，支持 hook、字段添加、日志级别设置等特性，适合需要灵活性的项目。

使用步骤如下：

安装依赖：

go get -u github.com/sirupsen/logrus

基本使用示例：

package main

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

func main() {
    // 设置日志格式为 JSON，默认就是 JSON，也可以改为文本
    log.SetFormatter(&log.JSONFormatter{})

    // 输出到文件或控制台都可以通过 SetOutput 自定义
    log.SetLevel(log.InfoLevel)

    log.WithFields(log.Fields{
        "animal": "walrus",
        "size":   1,
    }).Info("一条 info 日志")

    log.Error("出错了")
}

实用建议：