Golang日志收集与输出实现示例

本文深入解析了Go语言中使用标准log包实现日志收集与输出的最佳实践，涵盖文件日志的正确打开方式（必须指定os.O_APPEND|os.O_CREATE|os.O_WRONLY标志）、复用logger实例避免性能损耗、全局重定向log.SetOutput的时机陷阱、按级别分流到不同文件的前缀模拟方案，以及为何坚决摒弃fmt.Fprintln等不安全写法——强调log包内置的时间戳、行号定位、并发安全和格式统一等不可替代优势，为Golang开发者提供了一套轻量、可靠且易于演进的日志落地指南。

用 log 包写最简日志到文件

Go 标准库的 log 包开箱即用，但默认输出到 os.Stderr，要存文件得手动替换输出目标。常见错误是直接传入 os.OpenFile 返回的 *os.File 却没设 os.O_APPEND | os.O_CREATE | os.O_WRONLY 标志，导致日志覆盖或写入失败。

实操建议：

• 用 os.OpenFile 时必须显式指定标志位，推荐组合：os.O_APPEND | os.O_CREATE | os.O_WRONLY
• 日志对象应复用，不要每次写都新建 log.New 实例
• 记得在程序退出前调用 file.Close()（或用 defer）

file, err := os.OpenFile("app.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
    log.Fatal(err)
}
defer file.Close()

logger := log.New(file, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
logger.Println("服务启动完成")

用 log.SetOutput 全局重定向标准日志

如果项目里大量用了 log.Println、log.Printf 等顶层函数，又不想逐个替换成自定义 logger，可以用 log.SetOutput 统一接管。注意：它只影响标准包的全局 logger，不影响你用 log.New 创建的独立实例。

容易踩的坑：

• 调用 log.SetOutput 必须在任何 log.Print* 调用之前，否则部分日志仍会输出到 stderr
• 若同时用多个日志文件（比如 info.log 和 error.log），不能靠 SetOutput 分流，得自己封装判断逻辑
• 多 goroutine 写同一文件安全，因为 log 包内部加了锁

file, _ := os.OpenFile("info.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
log.SetOutput(file)
log.Println("这条会进 info.log") // ✅
log.Printf("时间：%v", time.Now()) // ✅

按级别分流日志：info / warn / error 到不同文件

标准 log 包不内置级别概念，所谓 “level” 是靠不同 logger 实例 + 前缀模拟的。关键点在于：每个级别对应一个独立的 *log.Logger，且各自绑定不同的 io.Writer（即文件句柄）。

性能与兼容性提醒：

• 每个文件打开一次即可，别为每条日志都 OpenFile
• 不要用 os.Stdout 或 os.Stderr 混合写入多个文件，它们不是线程安全的跨文件目标
• 若后续想升级到 zap 或 zerolog，这种前缀式 level 设计基本可平滑迁移

infoFile, _ := os.OpenFile("info.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
warnFile, _ := os.OpenFile("warn.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
errorFile, _ := os.OpenFile("error.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)

InfoLogger := log.New(infoFile, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
WarnLogger := log.New(warnFile, "[WARN] ", log.Ldate|log.Ltime|log.Lshortfile)
ErrorLogger := log.New(errorFile, "[ERROR] ", log.Ldate|log.Ltime|log.Lshortfile)

InfoLogger.Println("配置加载成功")
WarnLogger.Printf("忽略无效配置项：%s", "timeout_ms")
ErrorLogger.Fatalln("数据库连接失败")

为什么不用 fmt.Fprintln 直接写文件？

有人图省事用 fmt.Fprintln(file, msg) 替代 log 包，短期能跑，但很快会暴露问题：没有时间戳、没有调用位置（log.Lshortfile）、不支持自动加前缀、并发写时不带锁、无法统一设置格式。尤其当需要排查线上问题时，缺失 log.Lshortfile 导致根本不知道哪行代码打了日志。

所以哪怕只是临时脚本，也建议走 log.New 流程 —— 多写三行初始化代码，换来的是可维护性和排障效率。

真正复杂的地方不在“怎么写进去”，而在“怎么让日志既不丢、不错序、不阻塞主流程、还能按需轮转”。基础示例只解决前半截，后面得靠 lumberjack 或直接切到结构化日志库。

今天关于《Golang日志收集与输出实现示例》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！