zap.NewDevelopment() 默认输出不带颜色、不换行、无调用位置，因未正确配置 encoder 和 writer；需用 consoleEncoder、AddSync(os.Stdout)、AddCaller() 和 AddStacktrace() 才实现终端友好日志。
直接用 zap.NewDevelopment() 就能输出结构化日志到终端，但默认不带颜色、不自动换行、不显示调用位置——这些不是 Zap 的问题，而是你没配对 encoder 或没传对 writer。
为什么 zap.NewDevelopment() 输出看起来“不像终端日志”
Zap 本身不关心终端渲染，它只负责把日志结构化后写入 io.Writer。默认 zap.NewDevelopment() 用的是 consoleEncoder，但它依赖底层 writer 是否支持 ANSI 转义序列（即颜色），且默认不加换行符（需手动 logger.Info("msg") 才触发 flush）。
- 现象：日志挤成一行、没有高亮、
caller字段为空、时间格式难读 - 根本原因：encoder 配置缺失或 writer 未 wrap
os.Stdout（比如用了os.Stderr但没设为同步） - 别误以为是 Gin 中间件问题——Gin 的
Logger()和 Zap 是两套体系；你要的是 Zap 自己输出到终端，不是替换 Gin 日志
终端友好型 zap.Logger 初始化要点
要让 Zap 在终端看得清、有颜色、带文件/行号、自动换行，关键在三处：
-
encoder必须用zapcore.NewConsoleEncoder(zap.NewDevelopmentEncoderConfig())，不能用JSONEncoder -
writer必须是zapcore.AddSync(os.Stdout)，不能是裸的os.Stdout（否则可能丢日志） - 必须启用
zap.AddCaller()和zap.AddStacktrace(zap.ErrorLevel)，否则 caller 和 panic 堆栈不显示
示例：
func NewTerminalLogger() *zap.Logger {
encoder := zapcore.NewConsoleEncoder(zap.NewDevelopmentEncoderConfig())
core := zapcore.NewCore(encoder, zapcore.AddSync(os.Stdout), zap.DebugLevel)
return zap.New(core, zap.AddCaller(), zap.AddStacktrace(zap.ErrorLevel))
}
和 Gin.LoggerWithConfig 混用时的坑
如果你既想保留 Gin 原生 Logger()，又想用 Zap 打印业务日志到终端，注意它们互不感知：
- Gin 的
Logger()写的是请求链路日志，Zap 写的是业务逻辑日志，两者共用os.Stdout会混在一起，但不会冲突 - 但若你用
gin.LoggerWithConfig把 Output 设为io.MultiWriter(..., zapLogger.Syncer)，Zap 的Syncer不是io.Writer，会 panic —— 正确做法是让 Gin 日志走自己的 writer，Zap 日志走自己的 - 常见错误：把
zap.Logger当作io.Writer直接塞进LoggerConfig.Output，报错cannot use logger (type *zap.Logger) as type io.Writer
调试阶段建议的最小可行配置
开发期快速验证 Zap 终端输出，别碰 lumberjack 或文件切割——先确保终端能看懂：
- 去掉所有
lumberjack、file、rotating相关代码 - 禁用
zap.AddCallerSkip（除非你封装了中间件，否则跳过会导致 caller 显示为 zap 包内部） - 用
sugar替代logger更省事：zap.NewDevelopment().Sugar()，支持sugar.Infow("msg", "key", value)，更贴近 printf 习惯
终端日志真正的复杂点不在初始化，而在于多 goroutine 场景下 stdout 的缓冲行为和信号中断时的 flush 时机——线上环境务必切到文件 + lumberjack，终端只留给 dev 环境。
