生产环境必须用zap.NewProduction()，因其默认禁用caller与debug、启用紧凑JSON、纳秒时间戳及内置采样，专为ELK/Loki解析、高并发低延迟设计；误用NewDevelopment()会导致日志膨胀3–5倍、解析失败、颜色符污染JSON流。
生产环境必须用 zap.NewProduction()，别自己拼 JSON encoder；全链路日志不是靠“加字段”堆出来的，而是靠请求生命周期内复用带上下文的 logger 实例。
为什么不能用 zap.NewDevelopment() 上线
zap.NewDevelopment() 默认用 console encoder，输出带颜色、文件名、行号，且开启 debug 级堆栈——这些对终端可读有用，但会污染 JSON 流。Kibana 或 Loki 解析时，颜色控制符（如 \x1b[36m）直接变成乱码字段，caller 字段格式也不兼容 ES 的 file 和 line 标准映射。实测日志体积膨胀 3–5 倍，写入延迟升高 20%+，采样逻辑也失效。
- 开发调试可临时启用，但压测前必须切回
zap.NewProduction() -
NewDevelopmentConfig().Build()和NewDevelopment()底层都是 console encoder，只是配置封装不同，同样不适用于结构化采集 - 时间戳强制纳秒级（
ts字段），不是为了“看起来精确”，而是方便 PromQL 按毫秒聚合、与 trace 时间轴对齐；转 ISO-8601 反而增加 encoder 开销
HTTP 中间件里怎么安全注入 trace_id 和 request_id
Zap 不解析 HTTP header，也不绑定 context，所有字段必须显式提取并挂载到单次请求的 logger 实例上。全局 logger 直接 .With() 会并发污染；每次 .With().Info() 又抬高 allocs/op（实测每秒多 120KB GC 压力）。
- 先取 header：
tid := c.GetHeader("X-Trace-ID")，为空则生成uuid.New().String() - 构造子 logger：
reqLogger := logger.With(zap.String("trace_id", tid), zap.String("request_id", c.Request.Header.Get("X-Request-ID"))) - 存入 Gin context：
c.Set("logger", reqLogger)，下游用c.MustGet("logger").(*zap.Logger)取出 - 禁止写法：
logger.With().Info("msg")——没传字段也触发新建实例，纯属浪费
lumberjack 轮转 + Filebeat 采集时为什么丢日志
lumberjack.Logger 是个带切割逻辑的 io.WriteCloser，Zap 写进去前必须满足三个硬性条件，否则静默失败：目录不存在、权限不足、MaxSize 单位误设为 KB。
立即学习“go语言免费学习笔记（深入）”；
- 启动前必须
os.MkdirAll("/var/log/myapp", 0755)，否则 lumberjack 不报错也不写 -
MaxSize单位是 MB（不是字节），设100就是 100MB；MaxBackups别设1，建议 ≥5，避免旧文件被删太快 - Filebeat 必须开
force_close_files: true，否则轮转后新文件 inode 变了，Filebeat 还卡在旧句柄上读不到新日志 -
scan_frequency改成1s（默认 10s），但别更低；close_inactive: 5m和clean_removed: false配合使用
容器环境下该不该写文件
在 Kubernetes 或 Docker 中，优先输出到 os.Stdout，而不是本地文件。容器运行时自动捕获 stdout 并附加 Pod 元数据（namespace、pod_name、container_name），Fluent Bit / Promtail 能自动发现并转发，省去权限、路径、轮转等一堆运维负担。
- 写文件只在无采集 Agent 的裸机部署中必要；一旦用了 Filebeat，就得严格匹配
paths（如/var/log/myapp/*.log），且 Filebeat 用户要有读权限 - 每条日志必须是单行 JSON，结尾只能有一个
\n；用fmt.Fprintf(f, "%s\n", msg)比fmt.Fprintln更可控，避免 panic 堆栈被切碎 - panic 日志必须用 Filebeat 的
multiline合并：pattern 设为^panic:，negate: true，match: before，否则第一行关键词丢失
最易被忽略的是：trace_id 必须从入口中间件统一生成并透传，而不是每个服务自己 new 一个；字段命名（如 trace_id 而非 traceId 或 TraceID）要全链路一致，否则 Loki 的 LogQL 或 ES 的 KQL 查不到关联日志。
