Go 标准库提供了 runtime.Stack() 和 debug.Stack() 两种方式，可将当前 goroutine 的堆栈跟踪捕获为字节切片，再轻松转为字符串，适用于日志记录、错误诊断等场景。
go 标准库提供了 `runtime.stack()` 和 `debug.stack()` 两种方式，可将当前 goroutine 的堆栈跟踪捕获为字节切片，再轻松转为字符串，适用于日志记录、错误诊断等场景。
在 Go 开发中，有时需要在运行时捕获并处理堆栈跟踪（stack trace）——例如在 panic 恢复后记录详细调用链、构建结构化错误日志，或向监控系统上报异常上下文。虽然 runtime/debug.PrintStack() 仅支持输出到 os.Stderr，但标准库实际提供了更灵活的底层能力。
✅ 推荐方式：使用 debug.Stack()
debug.Stack() 是最简洁安全的选择。它内部自动分配足够大的缓冲区（默认上限为 1MB），调用 runtime.Stack(buf, false) 获取当前 goroutine 的堆栈，并直接返回 []byte。你只需一次类型转换即可获得字符串：
import "runtime/debug"
func getStackTrace() string {
return string(debug.Stack())
}
// 使用示例
func main() {
defer func() {
if r := recover(); r != nil {
log.Printf("panic occurred:\n%s", getStackTrace())
}
}()
panic("something went wrong")
}
⚙️ 进阶控制：使用 runtime.Stack()
若需更精细的控制（如限制堆栈深度、捕获所有 goroutines 或复用缓冲区以减少内存分配），可直接调用 runtime.Stack(dst []byte, all bool)：
- dst: 目标字节切片；若长度不足，函数返回 false 并不填充数据；
- all: 若为 true，则捕获所有 goroutines 的堆栈（调试时有用，但开销大）；false（推荐）仅捕获当前 goroutine。
func getStackTraceWithBuffer() string {
buf := make([]byte, 10240) // 预分配 10KB 缓冲区
n := runtime.Stack(buf, false)
if n == 0 {
return "stack trace unavailable (buffer too small)"
}
return string(buf[:n])
}
⚠️ 注意事项：
- debug.Stack() 在高并发或频繁调用场景下会产生额外内存分配，生产环境建议结合采样或错误级别（如仅在 Error 级别日志中启用）；
- runtime.Stack() 返回的堆栈包含运行时符号（如 runtime.gopark），不含源码行号（除非二进制未 strip 且启用了 DWARF）；
- 不要在性能敏感热路径中无条件调用——堆栈采集本身有可观开销（尤其 all=true 时）。
总之，debug.Stack() 是绝大多数场景下的首选：简短、安全、语义清晰；而 runtime.Stack() 则为需要极致控制或优化的高级用例提供支持。合理选用，可显著提升 Go 应用的可观测性与排障效率。
