Go 标准库 log.Logger 默认记录的是封装函数所在文件行号；通过调用 Logger.Output() 并显式指定 callDepth=2（或更高）可跳过包装层，准确显示业务代码的调用位置。
go 标准库 `log.logger` 默认记录的是封装函数所在文件行号；通过调用 `logger.output()` 并显式指定 `calldepth=2`（或更高）可跳过包装层，准确显示业务代码的调用位置。
在 Go 中封装日志函数（如 logging.Debug）时，一个常见痛点是：日志输出的文件路径和行号指向了日志封装层（如 logging.go:16），而非实际调用日志的业务代码（如 main.go:6）。这是因为 log.Logger.Printf 内部固定使用 callDepth = 2 查找调用栈——即从 Printf 自身向上数 2 层：Printf → Output → 调用方。而当你新增一层包装函数（如 Debug），调用栈变为 Printf → Output → Debug → main，此时默认 callDepth=2 就停在了 Debug 函数内部，导致文件信息失真。
解决方法是绕过 Printf，直接调用底层 Logger.Output(callDepth, msg)，并根据封装层级动态调整 callDepth：
- callDepth = 1：指向 Output 的直接调用者（即你的 Debug 函数）
- callDepth = 2：指向 Debug 的调用者（即 main.go 中的 logging.Debug(...)）✅
- 若有更多嵌套（如 Debug → wrapper → main），则需相应增加 callDepth
以下是修正后的 logging/logging.go 示例：
package logging
import (
"fmt"
"log"
"os"
)
var Logger *log.Logger
func init() {
// 注意：log.Llongfile 已足够，无需 log.LstdFlags 中重复包含时间（log.New 会自动加）
Logger = log.New(os.Stdout, "[Debug] ", log.Llongfile|log.LstdFlags)
}
func Debug(format string, v ...interface{}) {
// 使用 Output 替代 Printf，并设 callDepth=2，跳过 Debug 和 Logger.Printf 两层
msg := fmt.Sprintf(format, v...)
Logger.Output(2, msg) // ✅ 关键：2 表示“从 Output 向上数 2 级调用”
}⚠️ 注意事项：
- log.LstdFlags 默认包含时间戳和日期，若同时启用 log.Llongfile，日志格式为 [Debug] 2024/05/20 10:30:45 /path/to/file.go:line: message，无需手动拼接前缀；
- Logger.SetPrefix() 在每次 Debug 调用中执行是冗余的（init 已设好），且可能引发并发不安全问题（SetPrefix 非并发安全）；建议在初始化时统一设置；
- 若未来扩展 Info/Error 等多级别日志，应为每个函数单独指定对应 callDepth，避免复用同一逻辑出错；
- 更健壮的方案是使用结构化日志库（如 zap 或 zerolog），它们原生支持 Caller Skip 功能，且性能更优、线程安全。
通过 Output(2, ...) 显式控制调用栈深度，即可让日志精准回溯到开发者真正关心的业务代码位置，大幅提升调试效率。
