Go语言日志处理新利器：slog包详解（JSON输出格式实战指南）

为什么选择slog？

传统的 log 包虽然简单，但缺乏对结构化日志的支持。而 log/slog 是Go官方推出的现代化日志库，具有以下优势：

• 原生支持结构化日志（如JSON）
• 内置多种日志级别（Debug、Info、Warn、Error）
• 高度可扩展，支持自定义Handler和Formatter
• 性能优异，适合高并发场景

安装与基本用法

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

下面是一个最简单的JSON日志输出示例：

package mainimport (	"log/slog"	"os")func main() {	// 创建一个使用JSON格式的Logger	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))	// 设置全局Logger（可选）	slog.SetDefault(logger)	// 输出JSON格式日志	slog.Info("用户登录成功",		slog.String("username", "alice"),		slog.Int("userID", 1001),	)}

运行上述代码，你将看到类似如下的输出：

{"level":"INFO","msg":"用户登录成功","username":"alice","userID":1001}

自定义JSON日志格式

你可能希望在日志中包含时间戳、日志级别或服务名称等信息。slog允许你通过 slog.HandlerOptions 进行配置：

package mainimport (	"log/slog"	"os"	"time")func main() {	opts := &slog.HandlerOptions{		// 自定义时间格式		ReplaceAttr: func(groups []string, a slog.Attr) slog.Attr {			if a.Key == slog.TimeKey {				return slog.String("timestamp", time.Now().Format("2006-01-02T15:04:05Z07:00"))			}			return a		},	}	logger := slog.New(slog.NewJSONHandler(os.Stdout, opts))	slog.SetDefault(logger)	slog.Warn("数据库连接超时",		slog.String("db_host", "192.168.1.10"),		slog.Duration("timeout", 5*time.Second),	)}

输出结果：

{"level":"WARN","msg":"数据库连接超时","db_host":"192.168.1.10","timeout":5000000000,"timestamp":"2024-06-15T10:30:45Z+08:00"}

高级技巧：添加全局字段

在微服务架构中，你可能希望每条日志都包含服务名、环境或请求ID。slog提供了 With 方法来实现这一点：

// 创建带全局字段的LoggerbaseLogger := slog.New(slog.NewJSONHandler(os.Stdout, nil))appLogger := baseLogger.With(	slog.String("service", "user-service"),	slog.String("env", "production"),)// 使用新LoggerappLogger.Info("处理用户请求",	slog.String("request_id", "req-7890"),)

这样，所有通过 appLogger 输出的日志都会自动包含 service 和 env 字段。

总结

通过本文，你已经掌握了如何在 Go语言 中使用 log/slog 包输出 JSON格式 的结构化日志。无论是基础用法还是高级定制，slog都提供了简洁而强大的API。合理利用这些功能，可以显著提升系统的可观测性和运维效率。

记住，良好的日志实践是构建可靠系统的关键一环。现在就尝试在你的项目中集成slog吧！

关键词回顾：Go语言、slog、JSON格式、日志输出。