Go语言日志级别设置教程

Go语言标准log包天生缺乏日志级别控制能力，任何试图通过SetFlags、自定义Writer或字符串前缀“模拟”级别的做法都治标不治本；真正可靠的方案是切换至zap（生产首选，但需严格区分开发与生产配置）、谨慎使用logrus（注意其SetLevel非线程安全，须启动时固化或加锁保护），或在极简场景下手写前置判断的轻量级Logger——而比选库更关键的是统一管理级别来源（如环境变量、配置中心或热更新接口），这直接决定日志系统的可维护性与稳定性。

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的相关知识，请关注golang学习网公众号！