Golang 自定义日志级别过滤方法

Go标准库的log包缺乏原生日志级别过滤能力，导致开发者不得不在项目中自行封装：推荐采用结构体封装方案——定义含level字段的Logger，通过const明确级别常量，为每个Debug/Info/Warn/Error方法添加前置级别判断，并统一调用std.Output（calldepth设为2以准确定位调用行号），避免重复拼接字符串和格式失控；相较之下，基于io.Writer的运行时过滤虽可行，但需手动管理level前缀且易出错；若选用第三方库，zerolog在动态调级、线程安全和过滤可靠性上优于logrus，复杂场景下应优先考虑其原子级GlobalLevel机制而非重复造轮子。

Go 标准库 log 本身不支持 Level 过滤

标准 log 包的 log.SetFlags、log.SetOutput 都无法控制“只输出 ERROR 级别以上日志”。它没有 log.SetLevel 或类似接口。硬加 if 判断又会让调用点散落、易漏、难维护。

所以真实项目里，要么换日志库，要么自己封装一层——而封装的关键是：把 level 作为结构体字段 + 实现 log.Logger 要求的 Output 方法。

常见错误是直接在每个 Info/Error 方法里做字符串拼接再判断，这会导致重复计算和格式混乱；正确做法是统一走 Output 入口，在那里过滤。

用 io.Writer + 自定义 Write 实现运行时过滤

核心思路：让日志最终写入一个自定义 io.Writer，它的 Write([]byte) 方法先解析行首的 level 字符串（如 "ERROR"），再比对当前阈值。

但注意：标准 log 默认不输出 level 前缀，得先用 log.SetPrefix 或重写 Format —— 更稳妥的是不用标准 log，改用 log.New 构造带前缀的实例，并配合自定义 writer：

type LevelWriter struct {
    minLevel int
    out      io.Writer
}

func (w *LevelWriter) Write(p []byte) (n int, err error) {
    line := strings.TrimSpace(string(p))
    if strings.HasPrefix(line, "DEBUG ") && w.minLevel > 0 {
        return len(p), nil // 忽略 DEBUG
    }
    if strings.HasPrefix(line, "INFO ") && w.minLevel > 1 {
        return len(p), nil
    }
    if strings.HasPrefix(line, "WARN ") && w.minLevel > 2 {
        return len(p), nil
    }
    if strings.HasPrefix(line, "ERROR ") && w.minLevel > 3 {
        return len(p), nil
    }
    return w.out.Write(p)
}

使用时：

logger := log.New(&LevelWriter{minLevel: 2, out: os.Stderr}, "", log.LstdFlags)

⚠️ 注意：log.LstdFlags 不含 level 前缀，所以上面示例依赖你手动在每条日志开头拼 "INFO "。更实用的做法是：自己实现 Printf 类方法，统一控制前缀和过滤逻辑。

推荐方案：封装结构体 + 显式 Level 方法（如 logger.Error()）

这是多数 Go 项目实际采用的方式：定义 Logger 结构体，内嵌 *log.Logger，暴露 Debug/Info/Warn/Error 方法，每个方法先判断 level 是否达标，再调用底层 Output。

关键点：

• level 值用 const 定义（const ( DEBUG = iota; INFO; WARN; ERROR )），避免 magic number
• Output 的 calldepth 设为 2：跳过封装层，定位到真实调用行号
• 不要在每个方法里用 fmt.Sprintf 拼接完整字符串，而是传参给 log.Output，由它格式化（保持 log.Lshortfile 等 flag 生效）

示例节选：

type Logger struct {
    level int
    std   *log.Logger
}

func (l *Logger) Error(v ...interface{}) {
    if l.level 

第三方库选型要注意 context 和 Hook 支持
如果项目已用 logrus 或 zerolog，别重复造轮子。但要注意：
logrus 的 level 是全局或 per-logger 设置，但它的 Hook 在 level 判断之后触发，不能用于过滤；真正过滤得靠 logrus.SetLevel()，且必须在所有 logger 初始化后统一设——容易漏掉子 logger。
zerolog 默认无 level 字段，需显式调用 zerolog.LevelFieldName = "level" 并用 zerolog.SetGlobalLevel() 控制，它内部是通过 Writer 写入前检查字段值，比 logrus 更可靠。
如果你需要动态调整 level（比如 HTTP 接口热更新），zerolog 的 GlobalLevel 是原子操作，logrus 的 SetLevel 不是线程安全的，得自己加锁。
复杂点往往不在 level 逻辑本身，而在多 goroutine 场景下 level 变量的可见性与竞争——别假设“我只设一次就安全”。
以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。