开发用 zap.NewDevelopment()（consoleEncoder、颜色、完整字段名），上线用 zap.NewProduction()（jsonEncoder、字段压缩、采样），二者不可混用；误用会导致调试困难或日志膨胀。
别用 zap.NewDevelopment() 上线，也别用 zap.NewProduction() 调试——这不是命名习惯问题，是编码器和采样策略的硬性错配。
开发时日志全是 JSON、没颜色、没换行？你用了 zap.NewProduction()
本地调试时看到一长串紧凑 JSON，字段缩写（"m" 代替 "msg"）、时间是纳秒整数、没颜色、没对齐，说明你误用了生产配置。根本原因不是“环境没切对”，而是 zap.NewProduction() 默认启用 jsonEncoder + 字段名压缩 + 每秒同模板日志采样（只记前 100 条），完全不适合人眼阅读。
- 开发阶段必须用
zap.NewDevelopment()：它用consoleEncoder，自动换行、字段左对齐、带颜色、保留完整字段名（"level"不是"l"） - 如果非要自定义开发 logger，别改
encoding为"json"，否则等于自己废掉可读性 - K8s 或 systemd 环境下，即使输出到
stdout，也应优先用zap.NewProduction()—— 日志采集器（如 fluent-bit）专为解析 JSON 设计，不需要你手动转成文本再切分
上线后磁盘爆满、日志写满 inode？你用了 zap.NewDevelopment()
线上服务跑几天后 df -i 显示 inode 耗尽，或日志文件涨到几十 GB，大概率是把开发配置带上了线。zap.NewDevelopment() 不仅不采样、不压缩字段，还默认开启 caller（文件+行号）和堆栈展开，单条日志体积可能是 zap.NewProduction() 的 3–5 倍。
-
zap.NewProduction()默认启用采样：同一条格式的日志每秒最多记录 100 条，其余丢弃（可调） - 它用
jsonEncoder，字段名缩写（"msg"→"m"）、时间用UnixNano()整数，序列化开销更低 - 注意：
zap.NewProduction()默认禁用caller，如需保留（比如排查第三方库问题），得显式加zap.AddCaller()
zap.Stringer() 导致 panic？你传了 nil 指针
程序启动就 panic，错误信息是 panic: runtime error: invalid memory address or nil pointer dereference，十有八九是把一个 nil *string 或未初始化的结构体指针塞进了 zap.Stringer()。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
zap.String()对nil安全：传nil会输出空字符串"" -
zap.Stringer()会直接调用对象的String() string方法，如果方法里访问了未初始化字段，立刻 panic - 常见场景：HTTP 查询参数
r.URL.Query().Get("id")返回空字符串""，你误判为nil，转成*string后传给zap.Stringer() - 实操建议：不确定是否为
nil？统一走zap.String()；真要格式化复杂对象，先判空，再用zap.Object()或实现MarshalLogObject()
全局 *zap.Logger 字段丢失、并发写 panic？你没理解 logger.With()
你写了全局变量 var logger *zap.Logger，在 init() 里调 logger = logger.With(zap.String("service", "api"))，结果所有日志都没 service 字段——因为 logger.With() 返回新实例，原变量没更新。更危险的是多个 goroutine 并发赋值，触发竞态。
-
zap.Logger本身并发安全，但logger.With()是纯函数：返回新 logger，不修改原实例 - 错误写法：
logger = logger.With(...)在多个地方执行，导致最后只有最后一次赋值生效 - 正确做法：初始化时一次性构建好带基础字段的 logger，例如
logger = zap.NewDevelopment().With(zap.String("service", "api"))，之后全局复用这个实例 - 需要动态加字段（如 trace_id）？用
logger.With(zap.String("trace_id", tid)).Info(...)，不要反复赋值给全局变量
最易被忽略的一点：日志字段命名不统一。同一个业务字段，在用户模块叫 "user_id"，在订单模块叫 "uid"，查日志时得写两个条件，聚合分析直接失效。字段名不是“能看懂就行”，而是日志系统的查询索引。
