当前位置：首页 > 文章列表 > Golang > Go教程 > Golang日志添加方法：zap与logrus使用详解

Golang日志添加方法：zap与logrus使用详解

2026-03-31 20:48:18 0浏览收藏

在 Go 项目中，日志是保障系统可观测性与问题排查效率的核心环节，而 zap 和 logrus 作为两大主流日志库，分别以极致性能和高度可扩展性见长：zap 由 Uber 开源，专为高并发场景优化，支持结构化日志、低开销输出及 lumberjack 轮转；logrus 则凭借活跃社区、丰富 Hook 机制、直观 API 和灵活字段注入能力，成为定制化需求和新手入门的首选。本文深入对比二者使用方式、配置技巧与选型逻辑，助你根据性能要求、功能需求和团队成熟度，快速搭建高效、可维护的日志系统。

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("出错了")
}

实用建议：