Go log包不支持自动捕获调用栈，需结合errors.Wrap或fmt.Errorf("%w")包装错误并用"%+v"打印，或用runtime.Caller手动注入位置信息，避免裸错误返回和log.Fatal误用。
Go 标准库的 log 包本身不支持自动捕获调用栈，但结合 errors（尤其是 Go 1.13+ 的包装错误）和第三方工具（如 github.com/pkg/errors 或原生 runtime.Caller），可以记录带文件名、行号、函数名的详细错误上下文。关键在于：错误要被“包装”而非覆盖，日志要主动提取并输出调用位置。
使用 errors.Wrap 或 fmt.Errorf(%w) 包装错误
原始错误丢失上下文，必须在每一层调用中显式包装，保留原始错误链和当前位置信息：
- 推荐用 Go 1.13+ 原生方式：
fmt.Errorf("处理用户失败: %w", err)—— 自动携带调用点（需开启-gcflags="-l"编译，或依赖运行时解析） - 若需更稳定的位置信息，用
github.com/pkg/errors：errors.Wrap(err, "validate input")，它在创建时就记录runtime.Caller(1) - 避免直接返回裸错误（如
return err），否则上层无法知道该错误发生在哪一层
日志中打印错误详情与堆栈（非 panic 场景）
标准 log 不解析错误堆栈，需手动展开。对 pkg/errors 错误可用 errors.WithStack() + errors.PrintStack()；对原生 %w 错误，可用 fmt.Printf("%+v", err) 输出带行号的完整链：
- 记录时用
log.Printf("failed to save user: %+v", err)——%+v是关键，会显示每层包装的文件/行号/函数 - 若用
logrus或zap等结构化日志库，可配合github.com/mitchellh/go-homedir简化路径，或自定义字段写入errors.Cause(err).Error()和fmt.Sprintf("%+v", err) - 注意：不要在生产环境频繁用
%+v打印深层堆栈（性能开销略高），建议仅在 error 级别日志中使用
手动补充调用位置到日志（轻量替代方案）
不依赖错误包装时，可在日志语句中主动注入位置信息：
立即学习“go语言免费学习笔记（深入）”；
- 用
runtime.Caller(1)获取上层调用点：_, file, line, _ := runtime.Caller(1); log.Printf("[%s:%d] failed: %v", filepath.Base(file), line, err) - 封装成辅助函数：
LogError(err error, msg string)，内部自动追加位置，统一管理格式 - 适合简单服务或已有大量裸错误未包装的迁移过渡期
避免常见陷阱
- 不要用
log.Fatal替代错误处理——它会直接退出进程，掩盖真实错误传播路径 - 不要在 defer 中用
recover()后只打err.Error()—— 丢失堆栈，应打debug.Stack()或fmt.Sprintf("%+v", err) - HTTP handler 中不要把错误全打成
log.Println，而要用结构化字段（如req_id,path,status）关联错误日志，便于追踪
