当前位置：首页 > 文章列表 > Golang > Go教程 > Go slog.HandlerOptions AddSource 怎样输出调用位置

Go slog.HandlerOptions AddSource 怎样输出调用位置

来源：17golang原创 2026-10-22 21:45:04 0浏览收藏

我在给 Go 服务补结构化日志时，最先想要的不是更多字段，而是“这条日志到底从哪一行打出来”。slog.HandlerOptions 的 AddSource 就是为这个问题准备的：设置为 true 后，内置 Handler 会把日志调用的源文件和行号加入输出。官方资料入口：https://pkg.go.dev/log/slog#HandlerOptions。

AddSource 只负责让 Handler 生成 source 信息；TextHandler 会把它写成 文件:行号，JSONHandler 会写成结构化的 Source 记录。若日志函数再包了一层，调用位置可能变成包装函数，需要自己取得调用者的程序计数器。

AddSource 到底记录了什么

这个选项不是给日志消息自动追加一段字符串，而是让日志记录保留程序计数器，Handler 再根据它解析出调用位置。直接调用 logger.Info 时，通常能看到业务代码所在文件和行号；当调用经过自定义包装函数时，slog 反射调用栈得到的可能是包装函数那一行。

TextHandler 的结果适合人读，source 通常呈现为 source=service.go:42。JSONHandler 则把 source 作为结构化对象输出，便于采集端按 file、line 等字段检索。两者的共同点是：只有 Handler 开启 AddSource 且记录中存在源信息时，source 才会出现。

Logger、Record.PC、TextHandler、JSONHandler 与 source 属性的静态关系说明图 — 图1：结构说明图，查看 AddSource 记录调用位置并交给不同 Handler 输出的关系。

最小配置应该怎么写

先把 Handler 的输出目标和 AddSource 一起配置，再把 Handler 交给 Logger。这里用标准输出演示，代码中的中文注释只解释关键配置，不代表某次本机运行截图。

package main

import (
    "log/slog"
    "os"
)

func main() {
    handler := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
        // 打开调用位置，TextHandler 会输出 source=文件:行号。
        AddSource: true,
    })
    logger := slog.New(handler)

    // 这条日志的调用位置由 slog 记录并交给 Handler 格式化。
    logger.Info("开始处理订单", "order_id", 1001)
}

示例输出可以理解为下面这种形态，文件名和行号会随调用位置变化：

level=INFO source=service.go:18 msg="开始处理订单" order_id=1001

如果改用 slog.NewJSONHandler，字段仍然是结构化日志的一部分，不应再把整行文本拆分后猜测位置。实际项目应根据采集系统需要选择格式，而不是为了看到行号同时维护两套日志字符串。

包装 Logger 后 source 为什么会变化

这是最容易误判的地方。比如业务代码调用 Infof，而 Infof 内部再调用 logger.Info，slog 看到的直接日志调用点就是包装文件。官方包装示例的做法是先检查级别，再用 runtime.Callers 跳过 Callers 和包装函数本身，最后把得到的 PC 传给 slog.NewRecord。

func Infof(logger *slog.Logger, format string, args ...any) {
    // 被过滤的日志不需要计算格式化结果或继续取调用栈。
    if !logger.Enabled(context.Background(), slog.LevelInfo) {
        return
    }

    var pcs [1]uintptr
    // 跳过 runtime.Callers 和 Infof，保留 Infof 的调用者位置。
    runtime.Callers(2, pcs[:])
    record := slog.NewRecord(
        time.Now(),
        slog.LevelInfo,
        fmt.Sprintf(format, args...),
        pcs[0],
    )
    // 让原 Logger 的 Handler 继续负责 source 和最终格式化。
    _ = logger.Handler().Handle(context.Background(), record)
}

包装函数还要考虑参数计算成本和级别过滤。直接使用 logger.Info 的简单场景不必为了“看起来更底层”自己重建 Record；只有确实需要统一格式、保留业务调用者位置时，才值得采用这种包装方式。