Go语言日志实战（slog结构化日志完全入门指南）

什么是结构化日志？

传统日志通常是纯文本，例如：

User login failed for user john at 2024-05-20T10:00:00Z

而结构化日志则以键值对（key-value pairs）的形式组织数据，便于机器解析和过滤。例如 JSON 格式：

{  "level": "ERROR",  "msg": "User login failed",  "user": "john",  "time": "2024-05-20T10:00:00Z"}

这种格式不仅人类可读，还能被日志收集系统（如 ELK、Loki）高效处理。

安装与基本使用

由于 log/slog 是 Go 1.21+ 的标准库组件，你无需额外安装。只需确保你的 Go 版本 ≥ 1.21 即可。

最简单的使用方式如下：

package mainimport (	"log/slog"	"os")func main() {	slog.Info("Hello, structured logging!", 		"user", "alice",		"action", "login",	)}

运行后输出（默认为文本格式）：

INFO Hello, structured logging! user=alice action=login

使用 JSON 格式输出

在生产环境中，通常希望日志以 JSON 格式输出，便于日志系统解析。你可以通过设置 slog.NewJSONHandler 实现：

package mainimport (	"log/slog"	"os")func main() {	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))	logger.Info("User performed an action",		"user", "bob",		"resource", "profile",		"operation", "update",	)}

输出结果：

{"level":"INFO","msg":"User performed an action","user":"bob","resource":"profile","operation":"update"}

日志级别与上下文

slog 支持多种日志级别：Debug、Info、Warn、Error。你可以根据需要选择合适的级别。

此外，slog 还支持“带上下文的日志记录器”（Logger with context），即在创建 logger 时预设一些字段：

// 创建带服务名上下文的 loggerlogger := slog.With("service", "auth-service")// 后续所有日志都会自动包含 service=auth-servicelogger.Info("Processing login request", "user_id", 12345)

这在微服务架构中非常有用，可以自动为每条日志打上服务标识。

自定义 Handler 与选项

你可以通过 slog.HandlerOptions 自定义日志行为，例如添加时间戳、修改日志级别等：

opts := &slog.HandlerOptions{	Level:     slog.LevelDebug, // 记录 Debug 及以上级别	AddSource: true,          // 添加源码位置（文件:行号）}logger := slog.New(slog.NewJSONHandler(os.Stdout, opts))logger.Debug("This is a debug message")

总结

通过本教程，你已经掌握了 Go 语言中 log/slog 包的基本用法，包括：

• 什么是Go语言日志中的结构化日志
• 如何使用 slog 输出文本或 JSON 格式日志
• 如何利用上下文简化重复字段记录
• 如何配置日志级别和源码追踪

无论是开发小型工具还是大型分布式系统，slog结构化日志都能显著提升日志的可读性与可维护性。建议你在下一个 Go 项目中尝试使用它！

关键词回顾：Go语言日志、slog结构化日志、Go结构化日志教程、log/slog使用指南。