Go语言日志实战指南（slog结构化日志与日志级别详解）

什么是结构化日志？

传统日志通常是纯文本，例如：2024/05/20 10:00:00 User login failed。这种格式对人类友好，但难以被程序自动解析。

而结构化日志以键值对（key-value）形式记录信息，例如：

{  "time": "2024-05-20T10:00:00Z",  "level": "ERROR",  "msg": "User login failed",  "user_id": 123,  "ip": "192.168.1.100"}

这种格式便于日志系统（如 ELK、Loki）自动索引、过滤和告警，极大提升运维效率。

slog 的五大日志级别

log/slog 定义了五种标准日志级别，按严重程度从低到高排列如下：

• Debug：调试信息，通常仅在开发或问题排查时启用。
• Info：一般性信息，如服务启动、用户操作等。
• Warn：警告，表示潜在问题，但不影响当前功能。
• Error：错误，表示功能异常，需关注。
• Critical（或 Log）：严重错误，可能导致服务中断。

快速上手：你的第一个 slog 程序

首先，确保你使用的是 Go 1.21 或更高版本。然后创建一个简单的 Go 程序：

package mainimport (	"log/slog"	"os")func main() {	// 创建一个默认的日志处理器（Handler）	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))	// 设置全局日志器	slog.SetDefault(logger)	// 记录不同级别的日志	slog.Debug("This is a debug message", "user_id", 1001)	slog.Info("User logged in", "user_id", 1001, "ip", "192.168.0.1")	slog.Warn("Disk usage is high", "usage_percent", 85)	slog.Error("Database connection failed", "error", "timeout")}

运行后，你会看到类似以下的 JSON 格式输出（注意：默认情况下 Debug 日志不会显示，原因见下文）：

{"level":"INFO","msg":"User logged in","user_id":1001,"ip":"192.168.0.1"}{"level":"WARN","msg":"Disk usage is high","usage_percent":85}{"level":"ERROR","msg":"Database connection failed","error":"timeout"}

控制日志级别：只看你想看的

默认情况下，slog 的日志级别是 Info，这意味着 Debug 日志会被忽略。你可以通过配置 HandlerOptions 来调整最低日志级别。

// 启用 Debug 级别日志opts := &slog.HandlerOptions{	Level: slog.LevelDebug,}logger := slog.New(slog.NewJSONHandler(os.Stdout, opts))slog.SetDefault(logger)

这样，所有 Debug 及以上级别的日志都会输出。

自定义日志格式：TextHandler vs JSONHandler

slog 提供两种内置处理器：

• slog.NewTextHandler：输出类 key=value 的文本格式，适合开发环境阅读。
• slog.NewJSONHandler：输出标准 JSON，适合生产环境日志收集系统。

// 使用 TextHandlerlogger := slog.New(slog.NewTextHandler(os.Stdout, nil))// 输出示例：// time=2024-05-20T10:05:00.123Z level=INFO msg="User logged in" user_id=1001 ip=192.168.0.1

最佳实践建议

• 在开发环境使用 TextHandler + Debug 级别，便于阅读。
• 在生产环境使用 JSONHandler + Info 或 Warn 级别，减少日志量并兼容日志系统。
• 敏感信息（如密码、token）不要记录到日志中。
• 合理使用上下文字段（如 request_id、user_id），便于追踪请求链路。

结语

通过本文，你已经掌握了 Go 语言 log/slog 包的核心用法，包括结构化日志的输出、日志级别控制以及格式选择。无论你是刚接触 Go 的新手，还是希望升级现有日志系统的老手，slog 都是一个轻量、高效且标准的选择。

记住关键词：Go语言日志、slog结构化日志、Go slog教程 和 日志级别控制，它们将帮助你在实践中快速定位相关知识。