panic 默认输出太难读，怎么让堆栈带文件行号和函数名
Go 默认的 panic 输出只在最后几行显示错误位置，前面全是 runtime 内部调用链，根本看不出自己代码哪一行崩了。这不是 bug，是 Go 故意精简了启动时的堆栈截断逻辑——它默认只保留最顶层的 10 层（实际取决于 runtime.Stack 的内部阈值），且不强制展开 goroutine 上下文。
实操上最直接的办法是替换 panic 的钩子：用 debug.SetPanicOnFault(true) 没用（那是给 SIGSEGV 用的），真正有效的是重写 recover + 手动捕获并格式化堆栈：
- 在
main函数开头加defer捕获全局 panic：defer func() { if r := recover(); r != nil { buf := make([]byte, 4096) n := runtime.Stack(buf, false) fmt.Fprintf(os.Stderr, "panic: %v\n%s", r, buf[:n]) os.Exit(1) } }() -
runtime.Stack(buf, false)的第二个参数设为false是关键：它会抓当前 goroutine 的完整堆栈（含文件、行号、函数名），而不是所有 goroutine 的摘要 - 别用
log.Panic或第三方日志库的 panic 封装——它们往往默认调用os.Exit(2)前不给你干预机会
第三方库如 github.com/go-errors/errors 不值得引入
这类库想把 error 包一层再带堆栈，但实际踩坑多：它们通常靠 runtime.Caller 在构造 error 时拍一张快照，结果在 defer、闭包、goroutine 中调用时，快照位置完全错位；更麻烦的是，一旦 error 被多次包装（比如 fmt.Errorf("wrap: %w", err)），原始堆栈就丢了。
与其依赖这种“打点式”堆栈，不如聚焦在 panic 处理这一个入口点上做干净的事：
立即学习“go语言免费学习笔记（深入）”；
- Go 1.17+ 支持
errors.WithStack(err)？不存在，标准库没这个 API - 如果非要用 error 带堆栈，推荐
github.com/pkg/errors，但它已归档，且仅对errors.New和fmt.Errorf生效，对panic无感 - 真正稳定的做法是：业务层少用 panic，该返回 error 就返回；必须 panic 时，只在顶层
main或 HTTP handler 入口统一 recover + 格式化
HTTP 服务中 panic 堆栈怎么不暴露给客户端
直接打印到 stderr 的堆栈不会发给用户，但很多人忘了中间件或框架（比如 Gin、Echo）自带的 recovery 中间件默认会把堆栈写进响应体，甚至带完整路径——这是严重信息泄露。
以 Gin 为例，它的 gin.Recovery() 默认行为就是把 panic 详情吐到 HTTP body 里：
- 立刻禁用默认 recovery：
r.Use(gin.RecoveryWithWriter(io.Discard))，把输出丢掉 - 自己写一个 recovery 中间件，在
recover()后只记录日志（用zap或log/slog），并返回通用错误页或 JSON：func Recovery() gin.HandlerFunc { return func(c *gin.Context) { defer func() { if err := recover(); err != nil { // 记录带堆栈的日志（不返回给 client） log.Printf("panic: %v\n%s", err, debug.Stack()) c.AbortWithStatusJSON(http.StatusInternalServerError, map[string]string{"error": "internal server error"}) } }() c.Next() } } - 注意
debug.Stack()返回的是[]byte，不是字符串，别直接拼接进 JSON 字段里
测试时 panic 堆栈被 go test 拦截，怎么看到真实位置
go test 运行时会捕获 panic 并重写错误信息，导致你看到的堆栈顶部是 testing.tRunner，而不是你代码里的那行 panic("xxx")。
解决方法很简单，不用改测试代码：
- 加
-v参数运行：go test -v ./...，它会让每个测试的 panic 输出保持原样 - 如果还嫌不够，加
-gcflags="all=-l"关闭内联（-l是小写 L），避免 panic 被优化到调用方函数里，导致行号跳变 - 别在测试里用
assert.Panics类断言——它内部 recover 了 panic，你永远看不到原始堆栈；真要验证 panic，用testify/assert的PanicsWithError也得配合-v
复杂点在于：堆栈美化不是加个库就能一劳永逸的事。Go 的设计哲学决定了它不会在 runtime 层面提供“可配置的 panic 格式化器”，所有定制都得落在你自己的 recover 逻辑里——而且必须早于任何框架中间件执行，否则就被截胡了。
