go默认log包因无结构化、无上下文透传、不支持多输出及trace id注入，无法满足生产追踪需求；zap通过context集成、字段绑定与多写入器实现高可靠日志追踪。
为什么默认的 log 包不能直接用于生产环境追踪
Go 标准库的 log 包输出固定格式、不带上下文字段、无法动态分级、也不支持写入多目标（如同时打到文件和 stdout），更没法注入 trace ID 或 request ID。运维追踪要求日志能和一次请求/任务强绑定，否则查问题时根本串不起来。
- 默认日志没有结构化能力，
log.Printf输出纯字符串，grep 困难，ELK 解析失败 - 无 context 透传机制，goroutine 中丢失父级 trace ID 是常态
- 不支持日志采样、异步写入或自动轮转，高并发下容易阻塞主流程
-
log.SetOutput只能设一个 writer，无法分流（比如 error 写文件、debug 打屏）
用 zap 实现带 trace ID 的结构化 Logger
zap 是目前 Go 生产环境最主流的高性能结构化日志库，它原生支持 context.Context 注入、字段绑定、多写入器、日志等级控制，且零内存分配（核心路径）。
- 初始化时用
zap.NewProductionConfig()获取生产就绪配置，再手动开启Development: false和DisableStacktrace: true（避免非 error 日志打堆栈） - 通过
zap.String("trace_id", tid)显式传入 trace ID；更推荐封装一层：定义Logger.WithContext(ctx context.Context)方法，从ctx.Value("trace_id")自动提取（需配合中间件注入） - 错误日志必须带
zap.Error(err)，而非zap.String("err", err.Error())—— 前者会自动展开堆栈、类型、错误链，后者丢信息 - 示例片段：
logger := zap.New(zap.NewProductionConfig().Build()) ctx := context.WithValue(context.Background(), "trace_id", "tr-abc123") logger.With(zap.String("trace_id", ctx.Value("trace_id").(string))).Info("request received", zap.String("path", "/api/v1/users"))
如何让 Logger 自动携带 HTTP 请求的 trace ID
关键不在日志本身，而在请求生命周期中把 trace ID 注入 context.Context，并确保所有下游调用（DB、RPC、子 goroutine）都继承该 context。
- 在 HTTP handler 入口生成或提取 trace ID：
req.Header.Get("X-Trace-ID")，为空则用uuid.NewString()生成 - 用
context.WithValue(r.Context(), "trace_id", tid)构造新 context，并传给业务逻辑层（不要用全局变量存 trace ID） - 所有调用链必须显式传递 context：比如
db.QueryContext(ctx, ...)、http.NewRequestWithContext(ctx, ...) - 避免常见坑：
-
go func() { logger.Info(...) }()这种闭包会捕获旧 context，必须写成go func(ctx context.Context) { logger.With(...).Info(...) }(r.Context()) - 中间件顺序错乱导致 trace ID 覆盖（比如 auth 中间件覆盖了 trace 中间件的 context）
-
日志输出到文件 + 控制台 + 远程服务的组合写法
zap 支持多 WriteSyncer，但要注意：
文件写入需用
lumberjack.Logger做轮转（标准os.File不支持按大小/时间切分）
Miller CSV TSV JSON 数据处理器下载Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
控制台输出要加
zapcore.Lock(os.Stdout)防止多 goroutine 冲突推送到远程（如 Loki）不能阻塞主流程，必须用异步 channel + 后台 goroutine 拉取发送
-
组合示例：
fileWriter := zapcore.AddSync(&lumberjack.Logger{ Filename: "/var/log/app.json", MaxSize: 100, // MB MaxBackups: 5, MaxAge: 7, // days }) consoleWriter := zapcore.Lock(os.Stdout) core := zapcore.NewTee( zapcore.NewCore(encoder, fileWriter, levelEnabler), zapcore.NewCore(encoder, consoleWriter, consoleLevelEnabler), ) logger := zap.New(core)
trace ID 的透传和日志字段一致性，比日志库选型更关键。很多团队换了 zerolog 或 logrus，但没统一 context 注入点，结果还是查不出跨服务调用链。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
