初始化带时间戳和彩色控制台输出的 zerolog 实例需使用 consolewriter 并显式调用 timestamp()：consolewriter := zerolog.consolewriter{out: os.stdout, timeformat: time.datetime}; logger := zerolog.new(consolewriter).with().timestamp().logger()。
怎么初始化一个带时间戳和彩色控制台输出的 zerolog 实例
开发阶段直接看日志，没时间戳、没颜色、没上下文，等于白记。zerolog 默认不带这些，得手动加。
-
zerolog.New(os.Stdout)只是基础实例，输出纯 JSON 到 stderr，没颜色、没时间、没调用位置 - 要彩色控制台输出，必须用
zerolog.ConsoleWriter替换 writer，并传给zerolog.New() - 时间戳不是默认字段，得靠
.With().Timestamp()显式添加；否则Msg()输出里压根没有time - 彩色只在终端（TTY）生效，CI/容器里自动降级为无色 JSON，不用额外判断
示例：
consoleWriter := zerolog.ConsoleWriter{Out: os.Stdout, TimeFormat: time.DateTime}
logger := zerolog.New(consoleWriter).With().Timestamp().Logger()
logger.Info().Str("module", "auth").Msg("user logged in")
// 输出：2026-03-28 20:37:15 INF user logged in module=auth
为什么 SetGlobalLevel 不影响已创建的 logger 实例
因为 zerolog.SetGlobalLevel() 只控制「新创建」的日志器行为，老实例的级别是创建时就固化了的。
- 全局级别是 fallback 机制，仅用于未显式调用
.Level()的 logger - 如果你写了
zerolog.New(...).Level(zerolog.WarnLevel)，那它永远只打 warn 及以上，SetGlobalLevel(zerolog.DebugLevel)对它完全无效 - 常见错误：改了全局级别但日志还是不输出 → 检查是否已有 logger 实例被缓存或复用
- 微服务中多个模块各自 new logger 时，务必统一用全局级别 + 实例级覆盖，别混着来
文件日志怎么加轮转（rotate）且不丢日志
zerolog 本身不提供日志切割，硬写文件会撑爆磁盘，必须外挂轮转逻辑。
- 别用
os.Create()直接写死文件名，那是单文件模式，没有备份、不压缩、不按大小切 - 推荐用
github.com/natefinch/lumberjack包封装 writer，它支持MaxSize、MaxBackups、MaxAge、Compress - 注意：lumberjack 的
Write()是同步阻塞的，高并发下可能拖慢主流程，别在 hot path 上频繁打 info 级日志 - 若需异步写入，得自己套 goroutine + channel，但要小心 panic 后日志丢失 ——
lumberjack本身不保证 flush 完全落地
关键代码片段：
lw := &lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 100, // MB
MaxBackups: 5,
MaxAge: 30, // days
Compress: true,
}
logger := zerolog.New(lw).With().Timestamp().Logger()
Msg() 调用后还能不能追加字段或重试输出
不能。一旦调用 Msg() 或 Msgf()，这个 Event 就被消费并释放回对象池，再访问就是野指针或 panic。
- 错误写法：
e := logger.Info(); e.Str("a", "1"); e.Msg("start"); e.Str("b", "2").Msg("done")→ 第二行 panic - 链式调用本质是构建不可变事件，每一步返回新
*Event，旧的立即失效 - 想复用上下文字段？用
.With().Str("req_id", id).Logger()创建子 logger，它能继承字段且线程安全 - 调试时误以为可以“补字段”，结果日志断在中间 —— 这是最隐蔽的空指针来源之一
真正难的不是写对第一行 zerolog.New，而是所有子 logger 的生命周期管理、所有 Msg() 调用点的幂等意识，以及轮转 writer 在 crash 场景下的 flush 保障。这些地方一松懈，线上就只剩 JSON 碎片和空 log 文件。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
