生产日志必须用log.Printf配合显式格式控制，因其支持精准输出、%v安全打印error等；log.Println仅适合临时调试，会输出内存地址且不支持格式化；需时间戳和行号应设log.SetFlags(log.LstdFlags | log.Lshortfile)；写文件须用os.OpenFile检查err并复用句柄。
别用 log.Println 记生产日志，结构化、可检索、带上下文的日志必须用 log.Printf 配合显式格式控制；标准库不支持分级和字段打点，真要上生产请换 zap 或 slog。
log.Println 和 log.Printf 到底该用哪个
日常临时调试打点，log.Println 省事：自动加空格、末尾换行，适合快速验证流程。但一旦涉及变量拼接（比如 log.Println("user:", u)），结构体或指针会输出内存地址，不是字段值——你根本看不到实际数据。
log.Printf 是唯一能精准控制内容的入口：支持 %v 安全打印任意值（推荐用于 error）、%d/%s/%f 显式类型转换、对齐和宽度控制。漏写 \n 会导致多条日志挤在同一行，线上排查时极难识别。
- 记录错误：用
log.Printf("failed to read config: %v", err)，别手动调err.Error() - 记录用户行为：用
log.Printf("user login id=%d name=%q ip=%s", u.ID, u.Name, r.RemoteAddr) - 临时调试后想保留？立刻补上
\n，否则后续日志会粘连
怎么让每条日志带时间戳和文件行号
标准库默认不输出这些信息，log.SetFlags 是唯一开关，不是靠“重装包”或“改 import”。log.LstdFlags 已包含日期+时间（秒级），log.Lshortfile 输出 handler.go:42 这种紧凑格式，两者组合最实用。
立即学习“go语言免费学习笔记（深入）”；
错误写法：log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile) —— log.Ldate 和 log.Ltime 被 log.LstdFlags 包含，重复设置会导致时间重复打印，例如 "2026/05/26 17:05:00 2026/05/26 17:05:00 handler.go:15"。
- 正确写法：
log.SetFlags(log.LstdFlags | log.Lshortfile) - 需要微秒精度？加
log.Lmicroseconds，但高并发下有轻微性能抖动，非必要不加 - UTC 时间？加
log.LUTC，别混用本地和 UTC 标志位
如何把日志写进文件而不是终端
核心就一句：log.SetOutput(f)，但漏掉 os.OpenFile 的 err 检查，日志就静默丢失——没有报错、没有提示、只有空白文件，排查成本极高。
必须用 os.O_CREATE | os.O_WRONLY | os.O_APPEND 模式打开，避免覆盖历史日志；文件句柄要复用，不能每次写都 OpenFile，否则会泄漏句柄、触发 too many open files。
- 先确保目录存在：
os.MkdirAll("logs", 0755)，再开文件 - 打开后别
defer f.Close()—— 日志是长期服务，关闭后后续log.Printf全部静默失败 - 权限注意：
0644在 Linux 只影响新建文件，Windows 完全忽略；容器中 umask 可能覆盖它
为什么不要直接用全局 log 包写 HTTP 请求日志
在 Gin 或 net/http 中直接用 log.Printf 打请求日志，看似能跑，实则埋了四个硬伤：日志没请求 ID，多并发时完全无法关联；状态码、耗时、IP 得自己取自己拼，易漏或错位；同步写文件会卡住整个 HTTP 处理链路；无法按 level 动态开关（比如上线后关 info 日志）。
gin.Logger() 是最简替代：自动带方法、路径、状态码、耗时、IP 和时间戳，输出到 os.Stdout，无额外依赖。但它不记录 body、header，也不支持自定义字段（如 trace_id）。
- 要 JSON、要字段打点、要发 Kafka/ES？必须换
zap或slog，配自定义中间件 - 想同时写文件+控制台？用
io.MultiWriter(file, os.Stdout)传给log.SetOutput - 多个模块需不同前缀或输出目标？用
log.New创建独立实例，别死磕全局log
最常被忽略的其实是日志生命周期管理：文件句柄是否长期持有、log.SetOutput 是否被多次覆盖、log.Printf 的换行是否遗漏、错误是否用了 %v 而非 .Error()。这些细节不出问题时看不见，一出就是线上静默丢日志或排查时满屏乱码。
