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

Golang日志指南：zap与logrus使用详解

2025-08-21 11:26:24 0浏览收藏

有志者，事竟成！如果你在学习Golang，那么本文《Golang日志添加指南：zap与logrus使用详解》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

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

实用建议：