Go Academy · 课时

日志级别与属性

Q: 「日志级别与属性」这节课中我会学到什么？

为日志添加上下文 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

为日志添加上下文

日志级别与属性 是 CoddyKit 上的免费 Go Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

为日志添加上下文

单独的消息只能告诉您发生了什么；属性则会提供使日志具有可操作性的详细信息：是哪位用户、哪个请求，以及耗时多久。

四个级别

slog 的级别按严重程度从低到高排列：

Debug（-4）
Info（0）
Warn（4）
Error（8）

级别是整数，因此您可以在它们之间定义自定义级别。

按级别筛选

在 HandlerOptions 中设置最低级别。低于该级别的记录会以较低成本被丢弃。

package main

import (
    "log/slog"
    "os"
)

func main() {
    opts := &slog.HandlerOptions{Level: slog.LevelWarn}
    logger := slog.New(slog.NewTextHandler(os.Stdout, opts))
    logger.Info("ignored")
    logger.Warn("shown")
}

类型化属性

除了宽松的键值参数之外，slog 还提供了可避免错误且速度更快的类型化构造函数：

slog.String("k", v)
slog.Int("k", v)
slog.Bool("k", v)
slog.Duration("k", d)

slog.Info("done", slog.String("phase", "build"), slog.Int("files", 12))

类型化属性的优势

类型化属性可以在编译时发现“参数数量为奇数”的错误，并让处理程序跳过反射。在热路径中应优先使用它们。

对属性进行分组

slog.Group 会将相关字段嵌套到一个键下。

slog.Info("req",
    slog.Group("http",
        slog.String("method", "GET"),
        slog.Int("status", 200),
    ),
)

使用 Logger.With 共享上下文

logger.With(...) 会返回一个子日志记录器，为每条消息附加相同的属性。它非常适合记录请求 ID。

reqLog := logger.With("requestID", "abc-123")
reqLog.Info("started")
reqLog.Info("finished")

上下文感知的日志记录

*Context 变体（例如 InfoContext）会携带 context.Context，让处理程序能够提取跟踪 ID。

slog.InfoContext(ctx, "handling", "path", "/api")

动态级别

使用 slog.LevelVar 在运行时更改级别（例如在调查事件时提升到 Debug），无需重启程序。

var lvl slog.LevelVar
lvl.Set(slog.LevelInfo)
h := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: &lvl})
// later: lvl.Set(slog.LevelDebug)

将错误作为属性

将错误作为属性附加，使其可以被查询，而不是将错误拼接到消息中。

slog.Error("save failed", slog.String("err", err.Error()), slog.Int("retry", 2))

可运行：级别与 With

这个程序会按级别进行筛选，并使用带有共享上下文的子日志记录器。

package main

import (
    "log/slog"
    "os"
)

func main() {
    opts := &slog.HandlerOptions{Level: slog.LevelInfo}
    base := slog.New(slog.NewTextHandler(os.Stdout, opts))
    req := base.With("requestID", "r-7")
    req.Debug("hidden")
    req.Info("processing", slog.Int("items", 3))
}

快速检查

请测试您对级别和属性的理解。

回顾

您已了解级别和属性：

四个内置级别；使用 HandlerOptions.Level 进行筛选
类型化属性（slog.String、slog.Int）更安全、更快速
slog.Group 会嵌套字段；logger.With 会共享上下文
LevelVar 支持在运行时更改级别

常见问题解答

「日志级别与属性」课时是免费的吗？

是的 — 「日志级别与属性」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「日志级别与属性」这节课中我会学到什么？

为日志添加上下文你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「日志级别与属性」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy