zap 和 logrus 是 golang 中常用的日志库，分别适用于高性能和高扩展性场景。1. zap 由 uber 开源，适合高并发项目，支持结构化日志、多级别输出，可通过 lumberjack 实现日志轮转；2. logrus 社区活跃，提供丰富功能如 hook、字段添加等，适合需要灵活定制的项目，且 api 更直观易用；3. 选择建议：追求性能优先选 zap，需要功能扩展则选 logrus，新手推荐从 logrus 入门。两者都应合理使用字段、控制日志级别以提升维护效率。
在 Golang 项目中添加日志功能，是提升程序可维护性和排查问题效率的重要一步。如果你希望日志系统既高效又灵活，zap 和 logrus 是两个非常流行的选择：zap 更注重性能和结构化日志输出，logrus 则提供了更丰富的功能扩展和友好的 API。
下面分别介绍如何在这两种库中实现基本的日志记录功能，并给出一些实用建议。
使用 zap 添加日志功能
Zap 是 Uber 开源的一个高性能日志库，适合对性能要求较高的项目。它支持结构化日志、多种日志级别（debug、info、warn、error 等），并且可以配置输出到文件或控制台。
立即学习“go语言免费学习笔记（深入）”；
使用步骤如下：
- 安装依赖：
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("出错了")
}实用建议：
- 可以通过
WithField(s)添加上下文信息，方便调试。 - 支持 hook，比如将 error 日志发送到邮件或报警系统。
- 默认日志输出是并发安全的，但如果你自己加了 writer，要注意线程安全。
如何选择 zap 还是 logrus？
这个问题其实没有标准答案，取决于你的具体需求：
追求极致性能时选 zap
比如在高并发服务、微服务中，zap 的性能优势更明显，尤其是在大量日志写入场景下。需要更多定制功能时选 logrus
如果你需要日志 hook、多输出目标、或者想做日志上报等操作，logrus 提供了更灵活的接口。新手友好度上 logrus 更胜一筹
Logrus 的 API 更直观，文档也更丰富，适合刚接触 Go 日志系统的开发者。
基本上就这些。不管是 zap 还是 logrus，只要合理使用字段记录上下文信息、设置合适的日志级别、避免过多 debug 日志上线，都能帮你把项目中的日志管理做得不错。
