GolangLog/Slog日志包使用教程

本文深入解析 Go 语言新标准日志包 slog 的核心设计哲学与实战要点，直击开发者最常困惑的四大痛点：为何默认无时间戳和文件行号（源于“显式优于隐式”的性能优先理念）、With 与 WithGroup 的本质区别（扁平键值 vs 可嵌套命名空间，影响日志可读性与查询效率）、自定义 Handler 必须实现的三个易被忽略方法（Enabled、WithAttrs、WithGroup，缺一即导致静默失效），以及从传统 log.Printf 迁移时如何兼顾简洁性与结构化价值；同时强调——结构化日志真正的挑战不在语法，而在于团队对字段语义、命名规范与可观测场景的共识。

为什么 slog 默认输出没有时间戳和文件行号

因为 slog.NewTextHandler 和 slog.NewJSONHandler 默认不开启额外上下文字段，time、source（文件+行号）这些都得手动加。不是 bug，是设计上「显式优于隐式」——避免默认开销影响性能。

实操建议：

• 用 slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{AddSource: true, Level: slog.LevelInfo}) 启用源码位置
• 时间戳不用手动加：只要 Handler 支持（TextHandler/JSONHandler 都支持），它会自动写入 time 字段；但格式不可定制，想改格式得自己实现 slog.Handler
• 注意 AddSource 在生产环境可能有轻微性能损耗（需 runtime.Caller），上线前建议压测对比

slog.With 和 slog.WithGroup 什么时候该用哪个

With 是加扁平键值对，WithGroup 是建嵌套命名空间——不是语义区别，是结构差异。比如调试 HTTP 请求时，把请求头、参数、响应状态全塞进一个 group，比全打平更易过滤和解析。

常见错误现象：日志里一堆 user_id、req_id、status_code 平铺，查问题时分不清哪些属于同一请求上下文。

实操建议：

• 用 WithGroup("http") 包住一次请求的完整生命周期日志，后续所有 Info/Error 都自动带上 http.user_id、http.status_code 这类路径前缀
• With 适合临时上下文（如当前 goroutine 的 trace_id），WithGroup 适合有明确边界、可复用的逻辑单元（auth、db、cache）
• JSON 输出下，group 会生成嵌套对象；Text 输出则用点号连接键名（http.status_code），别指望 Text 日志能直接解析出层级

自定义 slog.Handler 时最容易漏掉的三个方法

写个自己的 Handler 不只是实现 Handle 方法就行。Enabled、WithAttrs、WithGroup 这仨没处理好，会导致日志被静默丢弃、属性丢失或 group 失效——而且很难 debug，因为没报错，只是“没打出想要的字段”。

使用场景：对接内部日志平台，需要把 slog 日志转成特定 protobuf 结构，或加统一 trace 上下文。

实操建议：

• Enabled 必须判断 level，否则 slog.Debug 在 prod 环境也可能执行（即使没输出）
• WithAttrs 要返回新 Handler 实例，不能原地修改，否则并发写日志会 panic
• WithGroup 如果不实现，调用方的 WithGroup 就完全失效，所有属性都变平级——这是最常被忽略的点

从 log 迁移到 slog 时 Printf-风格日志怎么处理

老代码里满屏 log.Printf("user %s login failed: %v", uid, err)，直接替换成 slog.Info("user login failed", "user_id", uid, "err", err) 很啰嗦，还容易漏字段类型（比如传了 int 却期望字符串）。

性能影响：用 slog.String、slog.Int 等构造器，比直接传原始值略慢一点，但换来的是类型安全和结构化能力，值得。

实操建议：

• 别硬改所有 Printf，优先在新模块、新服务里用 slog；老模块先加 slog.With("legacy", "true") 打标记，方便后期归因
• 用 slog.String("msg", fmt.Sprintf(...)) 临时过渡可以，但别长期留着——结构化日志的价值在于字段可检索，不是换了个壳继续拼字符串
• 注意 error 类型字段会被 slog 自动展开（包括 stack trace，如果实现了 Unwrap 或 StackTrace），不需要手动 fmt.Sprintf("%+v", err)

结构化日志真正难的不是语法，是决定哪些信息必须结构化、哪些可以丢进 message 字段——这取决于你的查询习惯和告警策略。字段一多，没人记得清 req_id 和 request_id 哪个才是标准名。

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