Golang日志输出与收集入门示例

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是Golang学习者，那么本文《Golang日志收集与输出基础示例》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

用log包写文件日志需用os.OpenFile指定os.O_APPEND|os.O_CREATE|os.O_WRONLY标志创建文件，复用log.Logger实例，避免覆盖或失败；可全局SetOutput重定向，但须在首次log.Print*前调用；按级别分流需多个独立logger绑定不同文件；不推荐fmt.Fprintln因缺失时间戳、行号、并发安全等特性。

用 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学习网公众号了解相关技术文章。