使用 zap 记录错误日志需安装包并选择合适模式。1. 安装 zap 使用 go get go.uber.org/zap；2. 导入包并根据环境选择 newdevelopment() 或 newproduction() 初始化 logger；3. 用 error 级别记录错误，推荐使用 zap.error(err) 结构化输出；4. 可封装 logger 为全局变量或工具函数统一管理；5. 注意调用 sync() 确保日志写入磁盘。
在 Golang 项目中记录错误日志，使用 zap 是一个高效又实用的选择。zap 是 Uber 开源的高性能日志库，支持结构化日志输出，能很好地满足生产环境的需求。
安装和引入 zap 包
要使用 zap，首先需要安装它。可以通过 go get 命令获取：
go get go.uber.org/zap
然后在代码中导入：
立即学习“go语言免费学习笔记（深入）”；
import (
"go.uber.org/zap"
)zap 提供了两种日志模式：开发模式（带有详细堆栈信息）和生产模式（JSON 格式、更高效）。你可以根据需求选择：
- 开发环境用
zap.NewDevelopment() - 生产环境用
zap.NewProduction()
例如初始化一个生产级别的 logger：
logger, _ := zap.NewProduction() defer logger.Sync() // 确保缓冲区的日志写入磁盘或标准输出
注意：不要忽略 Sync()，否则可能会丢失最后一段日志。
记录错误日志的基本方法
zap 支持多种日志级别，比如 Info、Warn、Error、DPanic、Panic、Fatal。记录错误时通常使用 Error 级别。
基本用法如下：
logger.Error("发生数据库连接错误", zap.String("error", err.Error()))上面的例子中，zap.String("error", err.Error()) 把错误信息以结构化的方式附加到日志中，方便后续分析系统提取字段。
如果你希望同时记录多个上下文信息，可以这样写：
logger.Error("处理请求失败",
zap.String("user_id", "12345"),
zap.String("error", err.Error()),
zap.Int("status_code", 500),
)这样的日志格式清晰，便于排查问题，也适合集成进 ELK 或者 Loki 这类日志收集系统。
更实用的技巧：封装成工具函数
为了方便在多个地方调用，可以把 logger 封装成一个全局变量或者工具函数。
例如定义一个 logutil 包：
// logutil/logutil.go
package logutil
import (
"go.uber.org/zap"
)
var Logger *zap.Logger
func InitLogger() error {
var err error
Logger, err = zap.NewProduction()
return err
}然后在 main 函数中初始化：
if err := logutil.InitLogger(); err != nil {
log.Fatalf("初始化日志失败: %v", err)
}之后就可以在其他包中直接使用：
logutil.Logger.Error("数据库查询失败", zap.Error(err))这样不仅统一了日志风格，还能灵活切换不同配置（比如测试环境用 development 配置）。
小细节：zap.Error 的使用建议
zap 提供了一个便捷的方法 zap.Error(err) 来记录错误类型。它会自动提取错误字符串并以 "error": "xxx" 的形式记录。
推荐优先使用这个方式，而不是手动调用 err.Error()。因为这样语义更明确，也更容易被日志平台识别。
举个例子：
if err != nil {
logger.Error("读取文件失败", zap.Error(err))
}这样输出的结果会是：
{
"level": "error",
"msg": "读取文件失败",
"error": "open file.txt: no such file or directory"
}结构清晰，可读性强。
基本上就这些。zap 的功能很丰富，但只要掌握这几个关键点，就能在项目中很好地记录错误日志了。
