Golang日志打印教程【收藏】

本文深入解析了Go语言标准日志库（log包）在实际开发中的核心使用陷阱与最佳实践：明确区分log.Println（适合临时调试）与log.Printf（必备于结构化、可检索、可运维的日志场景），详解如何通过log.SetFlags精准添加时间戳和行号，强调文件日志必须用os.OpenFile配合严格错误检查与正确打开模式，同时坦诚指出标准库在日志分级、上下文传递等关键能力上的根本性缺失，并给出从简易封装到迁移到zap/slog的务实演进路径——帮你避开线上排查中最常见的日志“静默丢失”“格式混乱”“无法关联追踪”等致命坑。

log.Println 和 log.Printf 到底该用哪个

直接结论：日常调试用 log.Println，结构化/可读性要求高的日志必须用 log.Printf。

log.Println 会自动在参数间加空格、末尾加换行，适合快速打点；但一旦涉及变量拼接（比如 log.Println("user:", user)），结构体或 map 会输出内存地址，不是你想要的字段值。

log.Printf 支持格式化，能精准控制输出内容和对齐，且不自动换行——漏写 \n 会导致多条日志挤在同一行，这是线上排查时最常被忽略的细节之一。

• 想打印用户 ID 和名字？用 log.Printf("user id=%d name=%s", u.ID, u.Name)，别用 log.Println("user id=", u.ID, "name=", u.Name)
• 错误日志建议统一用 %v： log.Printf("failed to parse config: %v", err)，避免手动调 err.Error()
• 如果只是临时看一眼，log.Println 省事；但只要日志要留存、要搜索、要进 ELK，一律上 log.Printf

如何让每条日志带时间戳和文件行号

标准库默认不带这些信息，必须显式启用——靠 log.SetFlags，不是靠“猜”或“重装包”。

log.LstdFlags 包含日期 + 时间（精确到秒），log.Lshortfile 输出 main.go:42 这种紧凑格式。两者组合最常用，也最实用。

• 正确写法：log.SetFlags(log.LstdFlags | log.Lshortfile)
• 别同时设 log.Ldate 和 log.Ltime——它们已被 log.LstdFlags 包含，重复设置会导致时间重复打印（例如 “2026/03/30 11:25:00 2026/03/30 11:25:00 handler.go:15”）
• 如需微秒级精度，加 log.Lmicroseconds；但注意：高并发下微秒时间戳可能引发轻微性能抖动，非必要不加

怎么把日志写进文件而不是终端

核心就一句：log.SetOutput 指向一个打开的 *os.File。但漏掉错误检查，日志就静默丢失，极难定位。

常见错误是：文件路径权限不对、目录不存在、没加 os.O_APPEND 导致日志被覆盖、忘记 defer f.Close() ——这些都会让后续所有 log.Print* 调用失败却无提示。

• 打开文件必须用 os.OpenFile，模式至少含 os.O_CREATE | os.O_WRONLY | os.O_APPEND
• 务必检查 err：if err != nil { log.Fatal("无法打开日志文件:", err) }，别只 log.Println 了事
• log.SetOutput(f) 后，所有顶层 log.Print* 都写入该文件——包括第三方库里没做隔离的 log.Printf 调用，这点容易被忽视

能不能实现 INFO/WARN/ERROR 分级

标准库不支持日志级别，所谓“分级”只能靠封装多个 log.Logger 实例，用前缀模拟，但没有语义控制力。

你可以定义 Info、Warn、Error 三个变量，各自指向不同前缀、不同输出目标（比如 Error 写 os.Stderr，Info 写文件），但它们彼此独立，无法统一开关、无法共用轮转逻辑、也无法绑定上下文字段（如 trace ID）。

• 简易封装示例：Info := log.New(os.Stdout, "[INFO] ", log.LstdFlags)，Error := log.New(os.Stderr, "[ERROR] ", log.LstdFlags)
• 别指望靠 log.SetPrefix 动态切换级别——它只影响默认 logger，对自定义实例无效
• 如果项目已上线或预期有中等以上流量，别硬扛：直接上 zap 或 Go 1.21+ 的 slog，它们原生支持级别、结构化、上下文、多输出，且性能更好

最常被低估的一点：标准 log 没有上下文传递能力。你在 HTTP handler 里生成了一个 trace ID，想让它自动出现在每条日志里？做不到——要么每条日志手动拼，要么换库。这不是配置问题，是 API 设计层面的缺失。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。