如何在 Go 中动态注入日志位置信息（文件名、函数名、行号）_技术教程

本文介绍如何利用 `runtime.caller` 在运行时自动获取调用点的源码位置（文件路径、函数名、行号），并将其 seamlessly 集成到日志语句中，替代手动硬编码（如 `"main.go:myfunction():..."`），提升可维护性与调试效率。

Go 语言本身不支持编译期宏或类似 C 的 __FILE__/__LINE__ 预处理指令，因此无法通过 go generate 直接“文本替换”日志语句中的 %fn% 占位符（如 fmt.Println("%fn%: There was an error:", e)）。go generate 是代码生成工具，作用于源码文件的静态分析与重写，而日志位置信息本质上是运行时上下文，必须在执行时动态捕获。 因此，正确方案是：放弃文本替换思路，改用运行时反射机制获取调用栈信息。

核心依赖是标准库 runtime 包中的 runtime.Caller() 和 runtime.FuncForPC()：

runtime.Caller(skip int) 返回调用方的程序计数器（pc）、源文件路径、行号及是否成功；
skip = 1 表示跳过当前函数，获取其直接调用者的位置（即日志语句所在位置）；
runtime.FuncForPC(pc).Name() 可解析出对应函数的完整包限定名（如 main.myFunc）。

以下是一个生产就绪的封装示例：

package main

import (
    "fmt"
    "runtime"
    "strings"
)

// CallerInfo 返回调用点的简洁信息：文件名（不含路径）、函数名（不含包前缀）、行号
func CallerInfo() (file, fn string, line int) {
    _, file, line, ok := runtime.Caller(1)
    if !ok {
        return "???", "???", 0
    }
    // 提取纯文件名（避免冗长绝对路径）
    if i := strings.LastIndex(file, "/"); i >= 0 {
        file = file[i+1:]
    }
    // 获取函数名并去除包名前缀
    if pc, _, _, _ := runtime.Caller(1); pc != 0 {
        if f := runtime.FuncForPC(pc); f != nil {
            fullName := f.Name()
            if i := strings.LastIndex(fullName, "."); i >= 0 {
                fn = fullName[i+1:]
            } else {
                fn = fullName
            }
        }
    }
    return
}

// LogWithLocation 封装日志输出，自动前置位置信息
func LogWithLocation(v ...interface{}) {
    file, fn, line := CallerInfo()
    prefix := fmt.Sprintf("[%s:%s:%d] ", file, fn, line)
    fmt.Print(prefix)
    fmt.Println(v...)
}

// 使用示例
func riskyOperation() error {
    return fmt.Errorf("something went wrong")
}

func main() {
    LogWithLocation("application started")
    if err := riskyOperation(); err != nil {
        LogWithLocation("There was an error:", err) // 输出：[main.go:main:19] There was an error: something went wrong
    }
}

✅ 优势说明：

零侵入修改：无需改动原有日志语句结构，仅需将 fmt.Println(...) 替换为 LogWithLocation(...)；
精准定位：skip=1 确保始终指向日志调用处，而非封装函数内部；
健壮容错：对 runtime.Caller 失败做兜底处理，避免 panic；
轻量无依赖：纯标准库实现，无第三方包引入。

⚠️ 注意事项：

runtime.Caller 有一定性能开销（需解析符号表），不建议在高频热路径（如循环内、微秒级关键逻辑）频繁调用；生产环境高吞吐日志推荐使用结构化日志库（如 zap）配合 CallerSkip 配置；
函数名截取逻辑基于 . 分隔符，适用于绝大多数 Go 函数命名规范；若需支持嵌套函数或特殊场景，可进一步增强解析逻辑；
go generate 在此场景下并不适用——它无法感知运行时调用栈，强行用于“替换 %fn%”属于误用，应明确区分编译期代码生成与运行时元信息获取的边界。