标准 log 包无日志级别功能,必须换库(如 zap)或用构建 tag 条件编译;zap 开发与生产配置差异大,需按场景选用;logrus setlevel 非线程安全,须启动时设定或加锁保护。

log 包默认不支持级别控制,别白费劲改 log.SetFlags
Go 标准库的 log 包压根没有 Debug、Info、Warn 这类级别概念——它只有 Print、Printf、Fatal 等输出方式,Fatal 会多加个 os.Exit(1),仅此而已。你调 log.SetFlags 或重写 log.Writer,都改不出级别开关。
常见错误现象:
– 写了一堆 log.Printf("[DEBUG] ..."),结果上线后还得手动删或注释
– 用 log.Lshortfile 想“模拟级别”,但日志里全是冗余前缀,过滤又麻烦
- 真正需要级别控制时,必须换库,不是“配置问题”,是能力缺失
- 如果项目已重度依赖标准
log,且无法引入第三方,只能靠构建 tag(如go build -tags debug)配合build constraints做条件编译 - 别在
init()里偷偷替换log.Printf为带判断的 wrapper——运行时开销不可控,且和log.SetOutput冲突
zap 是生产首选,但 zap.NewDevelopment() 和 zap.NewProduction() 行为差异极大
用 zap 时,别只看文档示例照抄 zap.NewDevelopment()。它默认开启 DebugLevel、彩色输出、行号、调用栈,适合本地调试;而 zap.NewProduction() 默认只打 InfoLevel 及以上,禁用颜色、压缩 JSON 字段名、强制同步刷盘——两者日志格式、性能、可读性几乎完全不兼容。
-
zap.NewProduction()的EncoderConfig.EncodeLevel默认用zapcore.CapitalLevelEncoder,输出"LEVEL":"INFO",不是小写"level":"info" - 想临时提级(比如某个 handler 打 Debug),不能直接改全局 logger,得用
logger.WithOptions(zap.IncreaseLevel(zap.DebugLevel)) - 如果用了
zapcore.NewCore自定义 encoder,记得显式传zapcore.AddSync(os.Stdout),否则NewCore不会自动接 stdout
logrus 已停止维护,但遗留项目还在用:小心 logrus.SetLevel() 的 goroutine 安全陷阱
logrus 的 SetLevel 不是原子操作,它直接写全局变量 logrus.level。如果多个 goroutine 同时调 logrus.SetLevel(logrus.DebugLevel) 和 logrus.SetLevel(logrus.WarnLevel),最终级别可能错乱,导致本该屏蔽的 Debug 日志突然涌出。
- 永远不要在运行时动态调
logrus.SetLevel()—— 改成启动时一次设好,或用环境变量初始化(如logrus.SetLevel(logrus.LevelFromString(os.Getenv("LOG_LEVEL")))) - 若真需运行时切级别,自己包一层 mutex:用
sync.RWMutex保护logrus.SetLevel调用,并用logrus.StandardLogger().SetLevel替代裸调 -
logrus.TextFormatter的DisableColors: true在 Windows 终端下不一定生效,得加ForceColors: false
自研轻量级级别控制,三行代码够用但有硬伤
如果就几个文件、没外部依赖、不想引 zap/logrus,可以手写一个带级别的 Logger 结构体。核心是封装一个 level int 和 output io.Writer,每个方法(Debugf、Infof)先比对当前 level 再决定是否调 fmt.Fprintf。
- 别用
fmt.Sprintf拼接再判断——参数计算和字符串分配已发生,级别过滤失去意义 - 必须用
if l.level >= DebugLevel { fmt.Fprintf(l.out, ...) }这种前置判断 - 这种实现无法继承标准
log.Logger接口(它没Debugf),所以旧代码里所有log.Printf都得手动替换成你的新方法
复杂点从来不在“怎么写级别”,而在“谁来统一管理级别来源”——环境变量?配置文件?HTTP 接口热更新?这些决策比选哪个库更影响长期维护成本。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











