runtime.Caller 的 skip 是固定偏移量而非深度上限，skip=n 直接取第 n+1 层帧；超出栈深时 ok=false，file/line 为空；应优先用 runtime.Callers + CallersFrames 获取准确调用信息。
runtime.Caller 的 skip 参数不是调用深度上限，而是固定偏移量
很多人误以为 runtime.caller(skip) 的 skip 是“最多往上查几层”，其实它只是从当前帧开始**硬跳过指定层数后取那一帧**。比如 skip = 3，就直接取第 4 层（0-index），不管调用链是否真有那么深。如果实际栈帧不足，ok 就是 false，不会 panic 或自动降级。
常见错误现象：在深度不确定的中间件或 defer 链中写死 skip = 2，结果某些路径下 ok == false，日志里打印出空文件/行号或 fallback 到 ???:0。
-
skip = 0→ 指向runtime.Caller所在函数内部的调用点（即该行代码） -
skip = 1→ 指向直接调用者（最常用） -
skip = 2→ 常用于 recover / error 构造函数中，跳过封装层本身 - 超过真实栈深度时，
ok为false，file和line是空值，pc是 0
runtime.Callers 返回的 uintptr 切片长度才是真实调用链长度
runtime.Callers 才是获取“完整调用链”的入口，它把从指定 skip 开始的所有帧 PC 地址写入你提供的切片。它的返回值 n 就是**实际捕获到的帧数**，也就是当前 goroutine 的有效调用深度（受限于切片容量和运行时栈布局）。
性能与兼容性影响：切片太小会截断；太大不浪费内存但多分配无意义。生产环境建议至少 64，避免中间件、goroutine 启动等隐式帧导致丢失顶层业务调用者。
- 必须预先分配足够大的
[]uintptr，例如pc := make([]uintptr, 64) -
n := runtime.Callers(2, pc[:])中的2含义同Caller：跳过自身 + 上一层封装 -
n可能远小于切片长度，只应遍历0..n-1范围内的pc[i] - 解析
pc[i]时需用runtime.FuncForPC(pc[i] - 1)，否则行号可能偏移 +1
内联（inlining）会让 skip 行为失效，且无法绕过
Go 编译器对小函数默认开启内联，一旦发生，调用栈帧被合并，runtime.Caller(1) 可能越过你预期的 caller，直接指向更上层（比如 main.main），甚至跳到 runtime.main。这不是 bug，是编译优化的必然结果。
容易踩的坑：在单元测试里验证 Caller 行为时一切正常，上线后因编译参数（如 -gcflags="-l" 关闭内联）不同，日志里函数名/行号突然错位。
- 无法在运行时检测函数是否被内联
- 加
//go:noinline注释可强制禁用单个函数内联，但会影响性能 - 日志或错误构造中若依赖精确 caller 名，应优先用
runtime.CallersFrames+Next()遍历，并检查Frame.Function是否含业务包路径，而非硬靠 skip - 不要假设
skip = 1总能得到“业务函数”，尤其在标准库包装层（如http.HandlerFunc）后
CallersFrames 解析比 FuncForPC 更可靠，但开销略高
runtime.CallersFrames 接收 runtime.Callers 返回的 PC 列表，返回一个迭代器，每次 Next() 给出完整的 runtime.Frame，含 Function、File、Line、Entry 等字段。它内部已处理 PC 对齐、符号表查找、内联帧过滤等细节，比手动配 FuncForPC 更健壮。
为什么不用它替代所有 Caller？因为初始化 CallersFrames 本身有额外开销，不适合高频打点场景（如每毫秒一次的日志）。但对于错误构造、panic 捕获这类低频但要求信息准确的场景，它是首选。
- 必须用
runtime.Callers先拿到 PC 列表，不能直接传单个pc -
Frame.Line是修正后的行号，无需再减 1 -
Frame.Function是全限定名（如myapp/handler.(*Server).ServeHTTP），比FuncForPC(pc).Name()更规范 - 若需跳过 runtime / vendor 帧，应在
Next()循环中用strings.HasPrefix(f.Function, "runtime.")过滤
调用链深度本身没有硬编码上限，但内联、栈帧裁剪、PC 解析失败这些现实约束，让“拿到稳定、准确的 caller 信息”这件事，始终依赖具体上下文——skip 值、是否禁内联、用 Caller 还是 CallersFrames，得看你是要快、要准，还是两者都要。
