Go语言日志级别控制教程

Go语言标准日志包天生缺乏日志级别控制能力，任何试图通过修改flags或封装Printf来“模拟”Debug/Info/Warn级别的做法都是徒劳且易出错的；真正可靠的方案是根据项目阶段和约束选用合适工具：轻量项目可用构建tag条件编译实现编译期级别裁剪，遗留系统需谨慎处理logrus的goroutine不安全SetLevel问题，而新项目应直接采用zap——但必须深刻理解Development与Production配置的本质差异，避免本地调试流畅、线上日志失能的陷阱；归根结底，日志级别的价值不在技术实现本身，而在于如何统一、安全、可维护地管理级别来源——环境变量、配置中心还是热更新接口，这个决策比选库更能决定系统的可观测性寿命。

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 接口热更新？这些决策比选哪个库更影响长期维护成本。

到这里，我们也就讲完了《Go语言日志级别控制教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！