本文详解在 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，即可精确控制每一条日志的去向。这套方法兼顾了可读性与可维护性，在生产环境中也经得起考验。
