标准库 log 不适合生产环境，因缺乏分级、轮转、结构化等关键能力；应使用 zap 等第三方库，配合 lumberjack 实现轮转，通过 with 注入请求上下文，用 atomiclevel 动态调级。
Go 标准库的 log 包足够轻量，但直接用它做生产级日志系统容易踩坑：不支持分级、无文件轮转、无法结构化输出。真正可用的日志系统，得靠 zap 或 zerolog 这类第三方库，而不是魔改 log.Printf。
为什么不用标准库 log 做业务日志
标准库 log 默认写到 stderr，没有日志级别控制（比如不能只关掉 DEBUG），也不带时间戳字段（得自己封装），更没法按大小或日期自动切分文件。你调 log.SetOutput 接个 os.File 是能写磁盘，但一旦日志涨到几个 GB，就得手动 mv + kill -USR1 —— Go 不支持热重载，也没内置轮转逻辑。
- 没
Infof/Warnf级别方法，只能靠log.Print模拟，易混淆 - 所有输出共用一个
mutex，高并发下成性能瓶颈 - 无法添加结构化字段（如
user_id=123、req_id=abc），排查时只能靠正则硬扒
用 zap 实现带轮转的结构化日志
zap 是目前最主流的高性能日志库，关键在于它区分了 Logger（可配置）和 SugaredLogger（易用但稍慢）。生产环境推荐用 Logger，配合 lumberjack 做轮转。
先装依赖：
立即学习“go语言免费学习笔记（深入）”；
go get go.uber.org/zap go get gopkg.in/natefinch/lumberjack.v2
再配一个带切割的写入器：
import (
"go.uber.org/zap"
"gopkg.in/natefinch/lumberjack.v2"
)
w := &lumberjack.Logger{
Filename: "/var/log/myapp/app.log",
MaxSize: 100, // MB
MaxBackups: 7,
MaxAge: 28, // days
Compress: true,
}
logger, _ := zap.NewProduction(zap.AddCaller(), zap.WriteTo(w))
-
MaxSize单位是 MB，不是字节；设太小会导致频繁切片，影响 I/O -
zap.NewProduction()默认禁用 caller（文件行号），加zap.AddCaller()才开启，但会略降性能 - 别用
zap.NewDevelopment()上生产——它输出 JSON 不紧凑，还带颜色控制符，日志系统可能解析失败
如何在 HTTP handler 中注入请求上下文字段
每个请求打日志时都带上 req_id、user_id 能极大缩短排查时间。不要每次 logger.Info("xxx", zap.String("req_id", reqID)) 手动传——用 With 提前绑定：
func myHandler(logger *zap.Logger) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
reqID := r.Header.Get("X-Request-ID")
userIP := r.RemoteAddr
log := logger.With(
zap.String("req_id", reqID),
zap.String("ip", userIP),
)
log.Info("request started")
// ... handle ...
log.Info("request finished")
}
}
-
With返回新Logger，是值拷贝，线程安全，可放心传给 goroutine - 避免在循环里反复
With，字段叠加太多会拖慢序列化速度 - 敏感字段如
password、token别打日志，哪怕打了也要在中间件里用zap.String("token", "[redacted]")显式脱敏
调试时临时启用详细日志的正确姿势
线上不敢开 DEBUG 日志，但本地调试又需要看 SQL 或 HTTP body？别改代码加 if debug { logger.Debug(...) } ——用 AtomicLevel 动态调级：
level := zap.NewAtomicLevel()
logger := zap.New(zapcore.NewCore(
zapcore.NewJSONEncoder(zapcore.EncoderConfig{...}),
zapcore.AddSync(os.Stdout),
level,
))
// 运行时切换
level.SetLevel(zap.DebugLevel) // 开启
level.SetLevel(zap.InfoLevel) // 关闭
- 必须用
AtomicLevel，普通Level是值类型，改了不生效 - 可以结合信号（如
syscall.SIGUSR1）实现运行时热切换，无需重启服务 -
DebugLevel下注意避免记录大对象（如整个 struct），容易 OOM；优先记录关键字段
日志系统真正的难点不在“怎么写”，而在“怎么查”和“怎么控”。字段命名是否统一、时间格式是否一致、错误码是否可检索、轮转策略是否匹配运维习惯——这些细节比选哪个库重要得多。
