Go语言控制台与文件日志分离级别输出实现

本文详解在 Go 语言中如何借助 logrus 等日志库实现日志级别分流：INFO 及以上级别仅输出到 stdout，DEBUG 及以上级别同时写入带时间戳的文件，解决单日志记录器无法差异化路由日志的核心痛点。

在 Go 语言的日志开发实践中，不少开发者常遇到这样一个尴尬场景：明明只想把 DEBUG 级别的调试信息写入文件以便后续排查，而 INFO 以上的正常运行状态直接打印到终端即可——但标准库里的 io.MultiWriter 只能将日志完整复制给多个输出目标，无法做到“把这条 DEBUG 塞进文件就行，别往终端上打”。换句话说，仅靠 log.SetOutput(io.MultiWriter(...)) 这条路，根本无法满足按级别分流的需求。

那么，有没有办法让日志输出“智能地按级别路由”？当然有。真正的解决方案是使用支持级别感知的结构化日志库，比如 Logrus（或其高性能替代方案 Zap），通过自定义 Hook 实现精准的日志分级路由。下面就来详细拆解这套方案。

✅ 推荐方案：Logrus + 自定义 Hook（支持级别分流）

package main

import (
    "io"
    "log"
    "os"
    "time"
    "github.com/sirupsen/logrus"
)

// LevelFileHook 将指定级别及以上的日志写入文件
type LevelFileHook struct {
    writer io.Writer
    levels []logrus.Level
}

func (h *LevelFileHook) Fire(entry *logrus.Entry) error {
    if !contains(h.levels, entry.Level) {
        return nil
    }
    line, err := entry.String()
    if err != nil {
        return err
    }
    _, err = h.writer.Write([]byte(line))
    return err
}

func (h *LevelFileHook) Levels() []logrus.Level {
    return h.levels
}

func contains(levels []logrus.Level, level logrus.Level) bool {
    for _, l := range levels {
        if l == level {
            return true
        }
    }
    return false
}

func main() {
    // 创建带时间戳的文件 Writer
    file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
    if err != nil {
        log.Fatal(err)
    }
    defer file.Close()

    // 初始化 Logrus
    logger := logrus.New()
    logger.SetFormatter(&logrus.TextFormatter{
        FullTimestamp:   true,
        TimestampFormat: time.RFC3339,
    })

    // Hook 1：仅 DEBUG 及以上写入文件
    logger.AddHook(&LevelFileHook{
        writer: file,
        levels: []logrus.Level{
            logrus.DebugLevel,
            logrus.InfoLevel,
            logrus.WarnLevel,
            logrus.ErrorLevel,
            logrus.FatalLevel,
            logrus.PanicLevel,
        },
    })

    // Hook 2：仅 INFO 及以上输出到 stdout（可进一步过滤为 INFO+）
    logger.AddHook(&LevelFileHook{
        writer: os.Stdout,
        levels: []logrus.Level{
            logrus.InfoLevel,
            logrus.WarnLevel,
            logrus.ErrorLevel,
            logrus.FatalLevel,
            logrus.PanicLevel,
        },
    })

    // 使用示例
    logger.Debug("Entering some func") // → 仅写入 app.log
    logger.Info("Result was: Successful") // → 同时输出到 stdout 和 app.log
}

解析一下这个方案的核心思路：每个 Hook 都可以独立声明自己关心的日志级别，Logrus 在生成日志条目时自动遍历所有 Hook，只有满足级别条件的 Hook 才会触发写入。上面的示例代码中，文件 Hook 接收 DEBUG 及以上所有级别，而终端 Hook 只接收 INFO 及以上——这样一来，DEBUG 日志仅写入文件，INFO 日志则同时输出到终端和文件。

⚠️ 注意事项

• io.MultiWriter 本质上是一个“全量复制器”，它会将所有日志原封不动地发送给每个 Writer，不区分日志级别，因此特别不适合需要按级别分流的场景。
• Logrus 的 AddHook 机制天然支持按级别过滤，每个 Hook 独立声明生效的级别，这是实现「分级路由」最直接、最标准的方式。
• 在生产环境中，建议优先考虑 Zap（性能优势显著）或 zerolog，它们同样提供了基于 Level 的 Writer 分流能力，并且内存分配控制更优。
• 文件写入的并发安全问题无需担心：Logrus 的 Hook 调用本身是线程安全的，而 os.File 底层也支持并发写入，无需额外加锁。

✅ 总结

Go 原生 log 包功能有限，无法原生支持“按级别分路径”的需求。Logrus 借助 Hook 扩展机制，以优雅的方式提供了可组合的解决方案：为每个输出目标注册对应的级别 Hook，即可精确控制每一条日志的去向。这套方法兼顾了可读性与可维护性，在生产环境中也经得起考验。