zap.NewDevelopment()用于本地调试，输出彩色对齐日志；zap.NewProduction()用于线上环境，输出精简JSON并启用采样。二者核心区别在于encoder行为与采样策略，非简单按环境命名。
zap.NewProduction() 和 zap.NewDevelopment() 用错场景
开发时用 zap.NewProduction()，日志全变成 JSON 且没颜色、没换行，查问题像在读压缩包；上线后用 zap.NewDevelopment()，日志体积暴增、磁盘写满得比服务崩得还快。
根本区别不在“开发/生产”字面，而在编码器行为和采样策略：
-
zap.NewDevelopment()用consoleEncoder，带颜色、字段对齐、自动换行，但不压缩字段名（比如输出"level":"info"而非"l":"info"） -
zap.NewProduction()默认启用jsonEncoder+ 采样（每秒同模板日志只记前 100 条），字段名缩写（"msg"→"m"），时间用 Unix 纳秒整数
建议：本地调试一律用 zap.NewDevelopment()；K8s 或 systemd 环境下，优先用 zap.NewProduction() 配合 stdout，别自己重定向到文件再轮转——日志收集器（如 fluent-bit）更擅长干这事。
zap.String() 和 zap.Stringer() 混用导致 panic
传一个 nil 指针给 zap.Stringer()，程序直接 panic： panic: runtime error: invalid memory address or nil pointer dereference。而 zap.String() 对 nil 安全，会输出空字符串。
立即学习“go语言免费学习笔记（深入）”；
常见踩坑点：
- 结构体字段是 *string 类型，没判空就直接塞进
zap.Stringer() - 自定义类型实现了
String() string，但方法里用了未初始化的成员变量 - HTTP 请求中取
r.URL.Query().Get("id")，结果是空字符串，但误以为是 nil，强行转成*string后传给zap.Stringer()
实操建议：不确定是否为 nil？统一走 zap.String()；真要格式化复杂对象，先判断是否为 nil，再调 zap.Object() 或自定义 MarshalLogObject() 方法。
全局 logger 被并发写入导致 panic
zap.Logger 本身是并发安全的，但很多人在 init 函数里这么写：
var logger *zap.Logger
func init() {
logger = zap.NewDevelopment()
logger = logger.With(zap.String("service", "api"))
}看着没问题，但 logger.With() 返回新实例，原 logger 变量没更新，后续所有 logger.Info() 其实用的是没加字段的老实例——不是 panic，是字段丢失，排查起来极隐蔽。
更危险的是：多个 goroutine 同时调 logger.With() 并赋值给同一个全局变量，会导致竞态，尤其在测试中偶发失败。
正确姿势：
- 全局 logger 一旦创建，就不再重新赋值；需要带字段的日志，用
logger.With(...).Info()链式调用，不存中间结果 - 若必须复用带固定字段的 logger（如按模块隔离），用不同变量名或 map 存储：
loggers["auth"] = logger.With(zap.String("module", "auth")) - 绝对不要在 goroutine 里修改全局 logger 变量
zap 无法输出到文件且没报错
代码里写了 os.OpenFile + zapcore.AddSync，运行也没报错，但日志就是不落盘。大概率是：你忘了把 core 塞回 zap.New()，或者 syncer 没被任何 logger 引用。
典型错误写法：
f, _ := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
core := zapcore.NewCore(encoder, zapcore.AddSync(f), level)——到这里就停了，没传给 zap.New()，等于白配。
关键点：
- zap 不管理文件生命周期，
os.File必须由你确保 close（通常 defer），否则进程退出前缓冲区内容可能丢失 - 如果用
lumberjack.Logger做轮转，它内部已封装 sync，直接传zapcore.AddSync(&lj)即可，别再套一层os.File - Windows 下路径含中文或空格时，
os.OpenFile可能静默失败，建议加if f == nil { panic(err) }显式暴露
最简可用文件 logger 示例：
f, _ := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
defer f.Close()
logger := zap.New(zapcore.NewCore(encoder, zapcore.AddSync(f), zapcore.InfoLevel))
字段缩写、采样开关、encoder 选型这些细节，往往比“怎么写第一行日志”更重要；没人告诉你 zap.String("error", err.Error()) 会让 panic 日志丢失原始 stack trace，这种事得自己试出来。
