Go语言log日志使用教程

Go标准库的log包虽轻量易用，但默认缺乏时间戳、日志级别和文件行号等关键排查信息，直接使用log.Println或log.Printf在生产环境中几乎无法定位问题；需手动调用log.SetFlags启用格式化输出，通过封装函数实现INFO/ERROR语义前缀，避免误用log.Fatal导致日志丢失或defer失效，而面对日志轮转、结构化输出、远程投递等真实运维需求时，则必须借助lumberjack、zap或zerolog等专业方案——学会“正确打日志”，远比“能打日志”更重要。

Go 标准库的 log 包适合轻量日志输出，但默认不带时间戳、级别标识或文件行号——直接用 log.Println 打印的日志在生产环境几乎无法排查问题。

为什么 log.Printf 打不出时间戳？

因为 log 默认只启用 log.LstdFlags 中的日期和时间部分，而它被禁用。标准初始化方式没设置标志位，输出就是纯文本。

• 正确做法是调用 log.SetFlags(log.LstdFlags) 或更常用的 log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
• Lshortfile 能显示 main.go:23，比 Llongfile 更简洁；但注意它依赖编译时的源码路径，交叉编译或 Docker 构建可能显示不全
• 如果用 log.SetOutput(os.Stdout) 重定向，必须在 SetFlags 之后调用，否则标志不生效

如何给每条日志加 INFO/ERROR 前缀？

标准 log 包本身不支持日志级别，log.Print 和 log.Fatal 只是行为差异（后者会 os.Exit），没有语义区分。

• 简单方案：自己封装函数，例如 func Info(v ...interface{}) { log.Printf("[INFO] %v", fmt.Sprint(v...)) }
• 注意不要直接拼接 fmt.Sprintf 再传给 log.Printf，否则丢失原始参数类型（如 error 的 %v 行为）；推荐用 fmt.Sprint 或 fmt.Sprintln 统一转字符串
• 若需结构化日志（如 JSON），别硬改 log，换 zap 或 zerolog——标准包不支持字段注入

log.Fatal 为什么没输出就退出了？

因为 log.Fatal 内部先调用 log.Output，再执行 os.Exit(1)。如果日志输出目标是缓冲的（比如写入文件但没 flush），或程序被 SIGKILL 强杀，就看不到那行日志。

• 调试时可临时替换为 log.Println + os.Exit(1)，确保日志落盘
• 在 defer 或 panic handler 中调用 log.Fatal 是危险的——它不会触发已注册的 defer，可能导致资源泄漏
• Web 服务中避免在 HTTP handler 里用 log.Fatal，应该返回错误并让顶层控制流程

真正麻烦的不是怎么打日志，而是日志该往哪写、谁来轮转、是否要同步到远程——这些 log 包完全不关心。一旦需要多级目录、按大小切分、保留 N 天，就得上 lumberjack 配合，或者直接切到更专业的日志库。

到这里，我们也就讲完了《Go语言log日志使用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！