log.SetOutput必须在main第一行调用，否则此前日志仍输出到os.Stderr；多目标用io.MultiWriter；*os.File不可共享以防竞态；log.SetFlags全量替换，需显式组合如log.LstdFlags|log.Lshortfile。
log.SetOutput 必须在 main 第一行调用
日志输出目标一旦设置就全局生效，但 log.SetOutput 调用太晚会导致部分日志仍写到 os.Stderr——比如在 init 函数或某个 handler 里才设置，之前 log.Println 已经输出了，这部分就找不回来了。
务必放在 main() 第一行，或至少在任何 log.* 调用之前。若需多目标（如同时写文件 + 控制台），用 io.MultiWriter(os.Stdout, file)，别自己写 goroutine 拼接。
-
*os.File必须是独占的：多个 logger 共享同一个*os.File会触发 write 竞态，出现日志错位或 panic - 调试时临时切回终端：
log.SetOutput(os.Stdout)；生产环境切文件前，记得用os.OpenFile(, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)并检查err
log.SetFlags 是全量替换，不是追加
log.SetFlags 不是开关式累加，而是直接替换整个标志位。默认值是 log.LstdFlags（含日期和时间），但它不含文件名和行号——很多人试了没效果，其实是忘了显式加上 log.Lshortfile。
Go 1.26.0 要时间戳 + 文件名 + 行号：必须写全 log.SetFlags(log.LstdFlags | log.Lshortfile)。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
log.Lmicroseconds不能单独用，得搭配log.Ltime，否则时间字段不显示 - 想彻底清空前缀（比如自己拼 JSON）：
log.SetFlags(0)，而不是log.SetFlags(log.Lshortfile)再删 -
log.Llongfile输出绝对路径，开发机路径可能泄露，CI/CD 环境慎用
log.Printf 漏换行会导致日志粘连
log.Printf 完全由格式串控制，不自动加换行；log.Println 才会自动追加 \n。漏写 \n 会导致多条日志挤成一行，线上排查时极难定位。
- 打印
error类型，用%v而不是%s：log.Printf("failed: %v\n", err) - 结构体、map 用
%+v才能看到字段值；log.Println(user)只输出{0xc000123456} - JSON 片段不要依赖
log.Println自动换行：log.Printf(`{"level":"info","msg":"%s"}\n`, "hello")，显式加\n更可靠
用 log.New 创建独立 logger 才能支持模块前缀和上下文注入
全局 log 不利于模块隔离。log.New 创建的实例完全独立，可带前缀、独立输出目标、独立 flag 设置。但注意：log.New 不会自动提取 context 中的 trace_id 或请求信息——它只是个封装，上下文注入必须手动做。
真正可行的上下文自动提取方式是：封装业务函数（如 SafeReadFile），在函数内部从 context.Context 提取 trace_id，再调用子 logger 记录；或在 HTTP 中间件中构建带字段的子 logger，传入 handler。
- 前缀字符串末尾要带空格，否则
[DB]2026/04/03会粘连 -
log.Lshortfile开销较大，生产环境慎用；调试阶段可加，上线建议去掉 - 别在
defer里记录成功日志——如果Close()失败，会覆盖前面的成功状态；应单独捕获错误并追加
标准库 log 的核心限制在于：它没有 context-aware 机制，所有“自动”都得靠你手动把 ctx 传进去、解析、塞进字段。想省事，就得换 zerolog 或 slog——但哪怕换，也要理解为什么 log.New 和 log.SetOutput 的时机、作用域、并发安全这些点，才是日志不出乱的根本。
