C++23 std::stacktrace使用详解

std::stacktrace 是 C++23 提供的轻量可移植堆栈跟踪工具，通过 std::stacktrace::current() 获取当前调用栈，支持直接输出、遍历帧及手动跳过前 N 帧，但不捕获变量、依赖调试信息、不自动集成异常处理。

std::stacktrace 是 C++23 引入的原生堆栈跟踪工具，它不依赖平台特定 API（如 libbacktrace、libunwind 或 Windows DbgHelp），而是由标准库直接提供轻量、可移植的调用栈快照能力。但它不是实时调试器，也不捕获变量或源码行号（除非编译器和调试信息支持），主要用于记录“当前执行到哪一层函数调用”。

怎么获取一个 stacktrace 对象

最常用方式是调用静态成员函数 std::stacktrace::current()：

#include <stacktrace>
#include <iostream>

void inner() {
    auto st = std::stacktrace::current(); // 捕获此刻调用栈
    std::cout << st << "\n";
}

void outer() { inner(); }
int main() { outer(); }

注意：current() 开销较小但非零，频繁调用会影响性能；它只在支持的平台（GCC 13+/Clang 16+，且启用调试信息如 -g）下才包含有意义的符号名。

如何打印/查看堆栈内容

std::stacktrace 重载了 <<，可直接输出到流（需链接 -lstdc++_lib 或等效支持）：

• 默认输出含函数名、模块名、可能的源文件与行号（取决于调试信息完整度）
• 若符号未解析，会显示类似 ??@0x7fff... 的地址回退格式
• 可用 st.to_string() 获取字符串，或遍历每一帧：for (const auto& frame : st) { std::cout << frame << "\n"; }

怎么控制堆栈深度和过滤无关帧

目前 std::stacktrace 不提供构造时截断或跳过帧的接口（如跳过 inner 自身）。但你可以手动处理：

• 用 st.size() 和 st[i] 索引访问特定帧（索引 0 是最内层，即当前函数）
• 常见技巧：跳过前 N 帧（比如封装日志函数时忽略日志包装层）：for (size_t i = 2; i < st.size() && i < 16; ++i) ...
• 没有内置过滤谓词，需自行比对 frame.to_string() 或用 frame.source_file()/frame.source_line() 做简单判断

注意事项和典型限制

这不是万能调试替代品：

• 不支持异常捕获时自动附加（需手动在 catch 块中调用 current()）
• 不解析内联函数、模板实例化细节，可能合并或省略帧
• Windows 上需 MSVC 19.35+ 且启用 /Zi 或 /Z7；Linux/macOS 需 DWARF 调试信息 + 地址映射支持
• 发布构建（-O2 -DNDEBUG）可能因优化导致帧丢失或顺序错乱

基本上就这些 —— 它小而专注，适合日志打点、panic 报告、轻量监控，但别指望它取代 gdb 或 lldb。