要实现结构化日志，必须显式创建 Logger 实例：用 slog.New(slog.NewJSONHandler(os.Stdout, nil)) 输出标准 JSON，或 slog.New(slog.NewTextHandler(os.Stdout, nil)) 输出可解析的 key=value 格式；所有字段须用 slog.String、slog.Int 等类型化构造函数，避免裸键值对导致 !BADKEY；HTTP 请求中通过中间件生成 trace_id 并用 slog.With 注入子 logger；建议启用 sloglint 强制类型化属性和敏感字段拦截。
slog 默认输出不是结构化的，直接用 slog.Info 会得到类 log.Printf 的扁平文本，不是你想要的 JSON 或 key=value —— 想用结构化日志，必须自己新建 Logger 实例。
怎么让 slog 输出 JSON 或 key=value 格式
默认的 slog.Info 等函数走的是全局默认 Logger，背后用的是 TextHandler 的简化版（不带结构），输出形如 2026/03/28 09:10:22 INFO user login user_id=123，看着像结构化，实则只是空格分隔，无法被 Loki、ELK 稳定解析。
- 要真正结构化，得显式创建
Logger：用slog.New(slog.NewJSONHandler(...))或slog.New(slog.NewTextHandler(...)) -
slog.NewJSONHandler(os.Stdout, nil)输出标准 JSON，每行一个对象，机器友好 -
slog.NewTextHandler(os.Stdout, nil)输出key=value键值对，人眼可读，也支持解析（比如 Grafana Loki 的 `pattern` 提取） - 两个 handler 都接受第二个参数
*slog.HandlerOptions，可用于控制时间格式、添加额外属性等
为什么不能直接传 "user_id", 123 而必须用 slog.Int("user_id", 123)
这是 slog 最容易翻车的地方：传原始键值对（"user_id", 123, "ip"）时，如果值数量是奇数，末尾缺值，slog 不报错，而是悄悄把最后一个 key 变成 !BADKEY —— 线上查日志时你会看到 "!BADKEY":"123"，根本找不到字段。
- 正确写法只有一种：
slog.String("user_id", "u_abc")、slog.Int("status_code", 200)、slog.Bool("is_admin", true) - 所有类型都有对应构造函数：
slog.Float64、slog.Time、slog.Duration、slog.Group（用于嵌套结构） - 编译器能帮你检查类型安全，比如
slog.Int("id", "abc")直接编译失败，比运行时报错强得多
如何在 HTTP 请求中自动带上 trace_id 或 request_id
微服务里靠日志串联请求链路，关键就是每个 log 都得带上下文 ID。slog 本身不绑定 context，但可以靠 With + Handler.WithAttrs 实现“一次注入，全程携带”。
立即学习“go语言免费学习笔记（深入）”；
- 别在每个
logger.Info里重复写slog.String("trace_id", tid)，太容易漏 - 推荐做法：在中间件里基于
http.Request生成 ID，然后用req.Context()存进去，再用slog.With(slog.String("trace_id", tid))创建子 logger - 或者更轻量：用社区库
github.com/veqryn/slog-context，它提供slogctx.With，自动从 context 提取并注入 - 注意：
With返回新Logger，不是修改原 logger，所以中间件里得把新 logger 塞进 context 或传给 handler
要不要用 sloglint 和自定义 linter 规则
不用的话，团队里很快会出现一半 slog.String、一半 "key", value 的混用，!BADKEY 问题反复出现，排查成本飙升。
- 装
sloglint：go install github.com/ettle/strcase/cmd/sloglint@latest - 加到 CI 或本地 pre-commit：运行
sloglint ./... - 配置
.sloglintrc强制require-typed-attrs: true，禁止裸键值对 - 顺手加
forbidden-keys: ["password", "token"]，防敏感信息误打日志
这些规则看起来琐碎，但一旦上线，就没人敢绕过 —— 比靠 Code Review 记住“别写错”靠谱得多。
