C++ std::stacktrace获取运行时调用栈的标准化方案

C++23 标准库引入了 <stacktrace> 头文件，为获取运行时调用栈提供了标准化、跨平台的解决方案。在此之前，开发者不得不依赖 POSIX 的 backtrace 函数、Windows 的 CaptureStackBackTrace 或第三方库（如 Boost.Stacktrace）。现在，你可以直接使用标准接口完成这项工作。

1. 确认编译环境支持

在使用 <stacktrace> 之前，必须确保你的工具链支持 C++23 标准，并且链接了必要的支持库（通常是 libstdc++_libbacktrace）。

检查 GCC 版本是否大于或等于 12.1。
检查 Clang 版本是否大于或等于 13.0。
确认编译器能够找到 libstdc++ 的开发库。在 Ubuntu/Debian 系统上，通常需要安装 libstdc++-12-dev 或更高版本。

2. 编写基础调用栈代码

创建一个名为 trace_demo.cpp 的文件。
写入以下代码，体验最基础的调用栈获取功能。这段代码定义了三个相互调用的函数，并在最深层函数中打印当前的调用栈。

#include <stacktrace>
#include <iostream>

void func_c() {
    // 获取当前调用栈并直接输出到标准错误流
    std::cout << "Current stacktrace:\n";
    std::cout << std::stacktrace::current() << std::endl;
}

void func_b() {
    func_c();
}

void func_a() {
    func_b();
}

int main() {
    func_a();
    return 0;
}

保存文件。

3. 解析调用栈详情

直接输出 std::stacktrace 对象虽然方便，但格式由编译器决定。如果需要自定义处理日志或提取特定信息（如文件名、行号），需要遍历 std::stacktrace 中的每一个 std::stacktrace_entry。

下表列出了 std::stacktrace_entry 的核心成员函数，用于提取信息：

修改 trace_demo.cpp，替换 func_c 的内容以演示详细解析：

#include <stacktrace>
#include <iostream>

void func_c() {
    std::stacktrace st = std::stacktrace::current();

    for (const auto& entry : st) {
        // 打印函数描述
        std::cout << "Function: " << entry.description() << "\n";

        // 打印文件名和行号（如果存在）
        if (entry.source_file() != "") {
            std::cout << "File: " << entry.source_file() 
                      << " Line: " << entry.source_line() << "\n";
        } else {
            std::cout << "File: (unknown)\n";
        }
        std::cout << "-------------------\n";
    }
}

注意：source_file 和 source_line 的可用性取决于编译时是否包含调试符号（即 -g 参数）。

4. 在异常处理中集成调用栈

在实际工程中，获取调用栈最常用的场景是捕获异常时记录现场。标准库的异常类并不直接携带调用栈，因此需要手动捕获。

编写一个异常处理宏或辅助函数，在 catch 块中记录堆栈。

替换 trace_demo.cpp 的全部内容为以下代码：

#include <stacktrace>
#include <iostream>
#include <stdexcept>
#include <string>

// 自定义异常类，携带调用栈信息
class TracedException : public std::runtime_error {
public:
    TracedException(const std::string& msg) 
        : std::runtime_error(msg), stack_(std::stacktrace::current()) {}

    // 获取存储的调用栈
    const std::stacktrace& get_stacktrace() const noexcept { return stack_; }

private:
    std::stacktrace stack_;
};

void risky_operation() {
    // 抛出异常，这里会记录构造异常时的调用栈
    throw TracedException("Something went wrong!");
}

int main() {
    try {
        risky_operation();
    } catch (const TracedException& e) {
        std::cerr << "Caught exception: " << e.what() << "\n";
        std::cerr << "Stack trace:\n" << e.get_stacktrace() << std::endl;
    }
    return 0;
}

5. 编译与链接

这是最关键的一步。由于 <stacktrace> 依赖于底层的符号解析库，编译时必须链接对应的库。

打开终端。
执行以下编译命令（以 GCC 为例）：

g++ -std=c++23 -g trace_demo.cpp -o trace_demo -lstdc++_libbacktrace

参数解析：

• -std=c++23：启用 C++23 标准。
• -g：生成调试信息，这是 source_file() 和 source_line() 能工作的前提。
• -lstdc++_libbacktrace：链接 GCC 的 libbacktrace 库，这是实现 stacktrace 的后端。

运行生成的程序：

./trace_demo

你将看到包含函数名、文件路径和具体行号的详细调用堆栈。如果行号显示为问号或为空，请检查是否使用了 -g 编译选项，以及优化选项（如 -O2）是否导致代码被优化内联（调试时建议使用 -O0）。