Go日志高效方案是zerolog+lumberjack组合：zerolog提供零分配JSON结构化输出，lumberjack实现安全文件轮转；需配置MaxSize、MaxBackups等参数，避免直接使用os.Stdout，支持多目标输出与异步写入，启动初始化并监听信号优雅关闭。
Go语言中实现高效的日志切割与结构化输出，核心在于选用轻量、稳定、可配置的第三方日志库（如 zerolog 或 zap），配合文件轮转机制（如 lumberjack），避免自行实现滚动逻辑带来的竞态与资源泄漏风险。
选择结构化日志库：zerolog + lumberjack 组合
zerolog 默认以 JSON 格式输出，无反射、零内存分配（配合预分配上下文），性能优于 logrus；lumberjack 负责安全的文件切割，支持按大小、时间、保留份数等策略。
- 安装依赖：go get github.com/rs/zerolog/log github.com/natefinch/lumberjack
- 日志写入器需包装 lumberjack.Logger 为 io.Writer，注意设置 MaxSize（MB）、MaxBackups、MaxAge（天）和 Compress（是否 gzip 压缩归档）
- 避免直接用 os.Stdout 或 os.Stderr 做日志输出——它们不支持轮转，仅用于调试或容器环境的标准流输出
配置日志层级与字段注入
结构化日志的价值在于字段可检索、易聚合。zerolog 支持链式添加字段（如 .Str("path", r.URL.Path)），也支持全局上下文（zerolog.Ctx()）注入服务名、请求 ID、环境等恒定信息。
- 用 zerolog.NewConsoleWriter() 在开发环境输出带颜色、可读的格式；生产环境保持纯 JSON 到文件
- 通过 zerolog.TimeFieldFormat = zerolog.TimeFormatUnix 统一时间戳格式，便于日志系统解析（如 ELK、Loki）
- 敏感字段（如 password、token）应显式过滤，zerolog 提供 With().Str("user_id", uid).Str("ip", ip).Caller().Timestamp().Msg("login") 方式控制字段可见性
支持多输出目标与异步写入
高并发场景下，同步写文件可能成为瓶颈。zerolog 支持 MultiLevelWriter 同时写入多个目标（文件 + stdout + 网络 hook），也可借助 chan 或 zerolog.ConsoleWriter 的 Out 字段做缓冲代理，但更推荐用 zerolog.New(os.Stderr).With().Logger() 配合独立 goroutine 消费日志事件（需自行管理 channel 容量与退出）。
立即学习“go语言免费学习笔记（深入）”；
- 若需异步且可靠，建议封装一个带 buffer 和 flush 控制的日志 writer，避免 panic 时丢失日志
- 不推荐在 HTTP handler 中每条日志都调用 time.Now() —— 使用 .Timestamp() 自动注入，由 zerolog 统一处理
- 错误日志建议用 .Err(err) 方法，它会自动展开 error 链并序列化为 "err"、"err_msg"、"err_kind" 等字段
启动时初始化与优雅关闭
日志实例应在 main 初始化阶段完成构建，并确保 lumberjack 文件句柄在程序退出前被正确 close，否则可能丢失最后一批日志或导致轮转异常。
- 使用 log.Output(zerolog.ConsoleWriter{Out: writer}) 或 log = zerolog.New(writer).With().Timestamp().Logger() 创建根 logger
- 监听 OS 信号（如 SIGINT/SIGTERM），触发 lumberjack.Logger.Close()（需提前保存引用），再执行其他清理逻辑
- 测试切割行为：手动触发大日志写入，验证 backup 文件生成、旧文件压缩、最大保留数生效
