Zap日志库指南-阿里云开发者社区

Zap日志库指南

2026-03-22 560

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： zap基本运用，本文将从入门zap、安装zap、使用zap，zap的进阶使用，来讲述zap的使用。

Zap是由Uber开发的高性能Go日志库，特别适合后端服务。

入门：

第一目：为什么要选择Zap？

在Go语言的日志库中，流行的有 zap、logrus...甚至还有Go自带的原生的log。

zap：极致性能(低延迟、低内存占用)、支持多种日志级别、偏底层、Uber官方维护并持续更新

Logrus：灵活易用、支持多种日志级别、高层封装支持全局调用、基本停滞更新

原生log包：简单易用的基础工具、学习成本低。高并发场景下性能也较低（文末有解释）

第二目：安装Zap

go get -u go.uber.org/zap

第三目：go语言简答的启动

package main
import (
  "go.uber.org/zap"
  "time"
)
func main() {
  // 创建生产环境使用的Logger（JSON格式）
  logger, _ := zap.NewProduction()
  defer logger.Sync() // 刷新缓冲区
    // Sync的作用，就是强制输出还在缓存区的内容
  // 记录不同级别的日志
  logger.Info("服务启动",
    zap.String("service", "user-api"),
    zap.Time("start_time", time.Now()),
  )
    // 打印
  logger.Warn("数据库连接缓慢",
    zap.Duration("duration", 150*time.Millisecond),
  )
  logger.Error("无法连接Redis",
    zap.String("host", "redis:6379"),
    zap.Error(err), // 假设有err变量
  )
}

输出示例

{"level":"info","ts":1690000000.1234567,"msg":"服务启动","service":"user-api","start_time":"2023-07-22T10:00:00Z"}
{"level":"warn","ts":1690000001.2345678,"msg":"数据库连接缓慢","duration":0.15}
{"level":"error","ts":1690000002.3456789,"msg":"无法连接Redis","host":"redis:6379","error":"connection refused"}

进阶：

第一目：自定义Logger配置：

func main() {
  // 创建自定义配置
  config := zap.NewProductionConfig()
  
  // 修改配置
  config.Level = zap.NewAtomicLevelAt(zap.DebugLevel) // 设置日志级别
  config.OutputPaths = []string{"stdout", "logs/app.log"} // 输出到控制台和文件
  config.EncoderConfig.TimeKey = "timestamp" // 自定义时间字段名
  config.EncoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder // ISO时间格式
  
  // 构建Logger
  logger, err := config.Build()
  if err != nil {
    panic(err)
  }
  defer logger.Sync()
  
  // 使用Logger
  logger.Debug("调试信息", zap.String("module", "authentication"))
}

第二目：创建开发环境Logger（易读格式）

func main() {
  // 开发环境使用更易读的控制台输出
  logger, _ := zap.NewDevelopment()
  defer logger.Sync()
  
  logger.Info("开发模式日志",
    zap.String("url", "/api/users"),
    zap.Int("status", 200),
  )
}
// 2023-07-22T10:00:00.123Z INFO  开发模式日志  {"url": "/api/users", "status": 200}

第三目：使用Sugar Logger（简化语法）

Sugar是zap提供的一种更灵活，更易用的日志记录接口。

格式化字符串与结构字段，语法更接近传统日志库，缺点就是性能略低。

func main() {
  logger, _ := zap.NewProduction()
  defer logger.Sync()
  // 创建Sugar Logger
  sugar := logger.Sugar()
  // 简化语法（性能略低于标准Logger）
  sugar.Infow("用户注册成功",
    "user_id", 12345,
    "email", "user@example.com",
    "registration_time", time.Now(),
  )
  // 格式化日志
  sugar.Infof("新请求: %s %s", "GET", "/api/users")
}
{"level":"info","ts":1753187495.5488393,"caller":"zap/main.go:92","msg":"用户注册成功","user_id":12345,"email":"user@example.com","registration_time":1753187495.5488393}

第四目：封装Logger（推荐）

对zap，封装成Init与Sync两个函数，需要时，调用即可。

// logger/logger.go
package logger
import (
  "go.uber.org/zap"
)
var Log *zap.Logger
func Init(debug bool) {
  var err error
  if debug {
    Log, err = zap.NewDevelopment()
  } else {
    Log, err = zap.NewProduction()
  }
  
  if err != nil {
    panic(err)
  }
  
  // 添加全局字段（服务名、版本等）
  Log = Log.With(
    zap.String("service", "user-service"),
    zap.String("version", "1.0.0"),
  )
}
func Sync() {
  _ = Log.Sync()
}

第五目：在项目中如何调用

// main.go
package main
import (
  "your-project/logger"
  "net/http"
)
func main() {
  // 初始化Logger
  logger.Init(true) // 开发模式
  defer logger.Sync()
  
  http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
    logger.Log.Info("处理请求",
      zap.String("path", r.URL.Path),
      zap.String("method", r.Method),
    )
    
    w.Write([]byte("Hello, World!"))
  })
  
  logger.Log.Info("启动HTTP服务", zap.String("port", "8080"))
  http.ListenAndServe(":8080", nil)
}

第六目：日志切割

一、安装Lumberjack：

go get gopkg.in/natefinch/lumberjack.v2

二、配置日志切割

import (
  "go.uber.org/zap"
  "go.uber.org/zap/zapcore"
  "gopkg.in/natefinch/lumberjack.v2"
)
func getLogWriter() zapcore.WriteSyncer {
  lumberJackLogger := &lumberjack.Logger{
    Filename:   "logs/app.log", // 日志文件路径
    MaxSize:    100,           // 单个文件最大大小(MB)
    MaxBackups: 5,             // 保留旧文件的最大个数
    MaxAge:     30,            // 保留旧文件的最大天数
    Compress:   true,          // 是否压缩/归档旧文件
  }
  return zapcore.AddSync(lumberJackLogger)
}
func main() {
  encoder := getEncoder()
  writer := getLogWriter()
  core := zapcore.NewCore(encoder, writer, zapcore.DebugLevel)
  
  logger := zap.New(core)
  defer logger.Sync()
  
  // 使用logger...
}
func getEncoder() zapcore.Encoder {
  encoderConfig := zap.NewProductionEncoderConfig()
  encoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder
  return zapcore.NewJSONEncoder(encoderConfig)
}

项目中，常用的就这些。

后续会补充。

日志级别的合理使用：

DEBUG：调试信息
INFO：重要流程信息
WARN：预期之外但可恢复的情况
ERROR：需要立即关注的错误
DPANIC/ PANIC/FATAL：严重错误（谨慎使用）

注：

Zap 使用 无反射设计（通过预定义字段类型避免运行时反射），且 内存预分配 减少 GC 压力。
原生 log 依赖 fmt.Sprintf() 进行字符串拼接，在高并发下性能损耗显著。

文章标签：

Java