Go 无内置函数直接获取当前函数名,需用 runtime.Caller(1) + runtime.FuncForPC 获取调用者函数名,但受符号剥离、内联优化影响,且性能开销大,应限于调试或错误日志使用。

Go 里没有内置函数直接返回当前函数名
Go 标准库不提供类似 Python 的 inspect.currentframe().f_code.co_name 或 C 的 __func__ 这种零开销、编译期确定的函数名获取方式。所有运行时获取函数名的方法都依赖 runtime.Caller 和符号解析,有性能开销且不可内联。
常见误用是试图用 reflect.TypeOf(func).Name(),但那只能拿到变量持有的函数值的类型名(比如 "func()"),不是调用点所在的函数名。
用 runtime.Caller + runtime.FuncForPC 获取调用栈中的函数名
这是最常用、也最可靠的方式:先定位调用栈帧,再查该地址对应的函数信息。关键在于传给 runtime.Caller 的层级参数——0 是当前函数(即你写这行代码的位置),1 是它的调用者,依此类推。
-
pc, _, _, _ := runtime.Caller(0)→ 得到当前函数内部某行的程序计数器地址 -
f := runtime.FuncForPC(pc)→ 查找该地址所属的函数元信息 -
f.Name()→ 返回完整包路径+函数名,如"main.main"或"github.com/user/pkg.(*T).Method"
示例:
func getCurrentFuncName() string {
pc, _, _, _ := runtime.Caller(1) // 调用者的名字,更符合“当前正在执行”的语义
f := runtime.FuncForPC(pc)
if f == nil {
return "unknown"
}
return f.Name()
}
func example() {
fmt.Println(getCurrentFuncName()) // 输出 "main.example"
}
注意 runtime.Caller 的三个易错点
这个组合看似简单,但实际使用中容易掉坑:
- 编译时加了
-ldflags="-s -w"会剥离符号表,runtime.FuncForPC返回nil,必须保留调试信息才能正常工作 - 内联优化(默认开启)可能导致
Caller(0)指向被内联后的外层函数,而不是你期望的函数;可用//go:noinline注释强制禁用内联 - 在 goroutine 启动函数(如
go fn())或 defer 中调用时,栈帧层级容易算错,建议统一用Caller(1)获取「调用我这个工具函数的地方」,比硬记层级更稳健
生产环境慎用,调试日志可考虑封装成条件开关
每次调用 runtime.Caller 需要捕获整个 goroutine 栈帧并做 PC 地址映射,实测比普通字符串操作慢 100 倍以上。线上高频日志里直接插 getCurrentFuncName() 可能成为瓶颈。
更务实的做法是:
- 仅在
debug模式或错误日志中启用 - 用
build tag控制是否编译进二进制,比如//go:build debug - 或者干脆用静态字符串标注,如
log.WithField("func", "example").Info(...),省去运行时开销
真正需要动态函数名的场景其实不多,多数时候是日志追踪或 panic 捕获——这些本身已是异常路径,少量开销可接受,但别让它出现在 hot path 里。


















