Go语言结构化日志入门（使用log/slog包实现高效日志记录）

什么是 log/slog？

log/slog 是 Go 1.21 新增的标准库包，专为结构化日志设计。它支持多种输出格式（如文本和 JSON），允许你以键值对的方式记录日志，并能轻松集成上下文信息（如请求 ID、用户 ID 等）。

快速上手：第一个 slog 示例

让我们从一个最简单的例子开始：

package mainimport (	"log/slog"	"os")func main() {	slog.Info("Hello, slog!", "user", "Alice", "age", 30)}

运行这段代码，你会看到类似这样的输出：

INFO Hello, slog! user=Alice age=30

这就是 Go语言 中使用 slog 包记录结构化日志的基本形式：日志级别 + 消息 + 任意数量的键值对。

日志级别

slog 支持以下日志级别（按严重程度递增）：

• Debug：调试信息（默认不输出）
• Info：一般信息
• Warn：警告
• Error：错误

配置日志输出格式

默认情况下，slog 使用文本格式。你也可以切换为 JSON 格式，便于日志收集系统（如 ELK、Loki）处理：

func main() {	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))	slog.SetDefault(logger)	slog.Info("User logged in", "user_id", 123, "ip", "192.168.1.1")}

输出将变为：

{"level":"INFO","msg":"User logged in","user_id":123,"ip":"192.168.1.1"}

添加全局上下文（With）

在 Web 应用中，你可能希望每个日志都包含请求 ID。可以使用 With 方法创建带上下文的新 logger：

func handleRequest(reqID string) {	logger := slog.With("request_id", reqID)	logger.Info("Processing request")	logger.Warn("Missing optional field", "field", "email")}

这样，所有通过该 logger 输出的日志都会自动包含 request_id 字段。

设置日志级别

你可以通过 HandlerOptions 控制最低日志级别：

opts := &slog.HandlerOptions{	Level: slog.LevelDebug,}handler := slog.NewJSONHandler(os.Stdout, opts)logger := slog.New(handler)slog.SetDefault(logger)slog.Debug("This will now be printed")

总结

log/slog 包是 Go 语言官方推荐的日志记录方式，特别适合需要结构化日志的现代应用。它简洁、高效、可扩展，并且无需引入第三方依赖。无论你是初学者还是经验丰富的开发者，掌握 slog 都能显著提升你的日志管理能力。

关键词回顾：本文涵盖了 Go语言、slog包、结构化日志 和 日志记录 四个核心 SEO 关键词，帮助你快速理解并应用这一强大工具。