Go 1.21+ 原生 slog 是最简可行的结构化日志方案，需显式指定 JSON/Text Handler、避免误用 slog.With、传值需符合序列化限制、按级别分离字段、注意输出链路缓冲与截断问题。
Go 用 log/slog 打印结构化日志最简可行路径
Go 1.21+ 原生 slog 是当前最轻量、无第三方依赖的结构化日志方案。不用引入 zap 或 zerolog 就能输出 JSON 或键值对格式，关键是它和标准库 log 接口兼容，迁移成本极低。
默认 Handler 是文本格式，要结构化必须显式指定：slog.NewJSONHandler(os.Stdout, nil) 或 slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{AddSource: true})。注意：Handler 一旦创建就不可变，HandlerOptions 中的 AddSource、Level 必须在初始化时设好，后续无法动态调整。
-
slog.With("user_id", 123, "action", "login")返回新Logger，不是修改原 logger —— 这是常见误用点，容易漏传上下文 - 避免在循环里反复调用
slog.With创建大量临时 logger；高频场景建议提取为局部变量复用 - 字段名不要带空格或特殊符号（如
"req id"），否则 JSON 输出会出错或被某些日志采集器截断
结构化字段该传什么类型？别传指针或未导出 struct 字段
slog 对值的序列化有明确限制：只支持基础类型、实现了 Stringer 接口的类型、map/slice/array（元素类型也需满足要求），以及导出字段的 struct。传 &myStruct{} 或含未导出字段的 struct，日志里只会显示 &{...} 或空对象。
- struct 日志字段务必用导出字段（首字母大写），例如
type ReqLog { UserID int `json:"user_id"` } - 时间建议用
time.Time而非字符串，slog会自动格式化为 RFC3339；自定义格式需提前转成字符串再传 - 错误类型直接传
err，slog会调用err.Error()并附上err.Unwrap()链（如果实现了） - 避免传
context.Context或http.Request等大对象——字段会被忽略或 panic，应提取关键字段再传
如何让日志同时满足调试、监控和审计需求？靠层级 + 属性分离
结构化日志的价值不在“有字段”，而在字段可被下游（Loki、ES、Prometheus Exporter）按需提取。一个请求生命周期内，不同阶段的日志应共享 trace ID，但字段粒度要区分：
立即学习“go语言免费学习笔记（深入）”；
- Debug 级别：加
"stack"（用runtime.Caller拼）、"duration_ms"、完整 request body（仅开发环境） - Info 级别：保留
"trace_id"、"method"、"path"、"status"、"size"—— 这些是监控告警的基础维度 - Warn/Err 级别：必须带
"error"（string）、"error_type"（fmt.Sprintf("%T", err)）、"cause"（errors.Unwrap(err)的第一层） - 审计日志单独走
slog.With("category", "audit")，字段强制包含"actor"、"target"、"action"，且不打任何敏感内容（密码、token、身份证号）
线上环境 JSON 日志被截断或解析失败？检查这三点
常见现象是 Loki 查不到日志、ES 中 message 字段为空、或者单行日志被切成多段。根本原因往往不是 slog 本身，而是输出链路中的缓冲或换行处理。
- 确保
os.Stdout没被包装成带缓冲的bufio.Writer——slog.JSONHandler自己会做行缓冲，双重缓冲会导致日志延迟或丢失 - 容器环境下，Docker / Kubernetes 默认按行拆分日志；若某次
slog.Info写入超长 JSON（比如带大 payload），会被截断；解决方法是预估最大长度，或改用slog.WithGroup分层组织字段 - K8s 中若用 Filebeat 或 Fluent Bit 收集，确认其 parser 配置支持
json编码，并启用了auto_decode_json（Filebeat）或Parser_JSON_Key_Name（Fluent Bit）
结构化日志最难的不是怎么打，而是字段命名是否一致、生命周期是否可控、以及上下游系统是否真正按结构消费——这些没法靠一个 slog.Info 调用解决，得从第一个 main.go 就约定清楚。
