Linux下用backtrace和backtrace_symbols获取符号化堆栈需编译时加-g、禁用strip，并启用-fno-omit-frame-pointer；backtrace返回地址数组，backtrace_symbols转换为符号名，结果需手动free。
Linux 下用 backtrace 和 backtrace_symbols 获取符号化堆栈
在 Linux（glibc 环境）中，最轻量、最常用的方式就是 execinfo.h 提供的 backtrace + backtrace_symbols 组合。它不依赖第三方库，编译时也不需要额外链接（-lexecinfo 在多数 glibc 系统上已内置），但要求程序编译时带调试信息（-g）且未 strip。
常见错误现象：backtrace_symbols 返回的地址全是 ??，或只显示十六进制地址没有函数名——这基本是因为没加 -g，或用了 -s strip 掉了符号表。
- 调用前需确保栈帧未被过度优化：函数加
__attribute__((noinline))或编译时加-O0/-fno-omit-frame-pointer（尤其在-O2下，-fno-omit-frame-pointer是必须的） -
backtrace返回的是原始地址数组，最多取 100–200 帧足够；再多容易越界或性能陡降 -
backtrace_symbols分配的内存需手动free，否则每次调用都泄露
#include <execinfo.h>
#include <stdio.h>
#include <stdlib.h>
void print_backtrace() {
void *buffer[128];
int nptrs = backtrace(buffer, 128);
char **strings = backtrace_symbols(buffer, nptrs);
if (strings) {
for (int i = 0; i < nptrs; ++i) {
printf("%s\n", strings[i]);
}
free(strings); // 必须 free
}
}
macOS 上 backtrace 不可用，改用 _Unwind_Backtrace
macOS 的 libc 不提供 backtrace，直接调用会链接失败（undefined symbol: backtrace）。必须切换为基于 libunwind 的方案，_Unwind_Backtrace 是系统级稳定接口，Xcode 自带，无需额外依赖。
使用场景：跨平台 C++ 日志/崩溃捕获模块，在 macOS 上不能简单 #ifdef 跳过，必须提供等效实现。
立即学习“C++免费学习笔记（深入）”；
- 需要自己实现
_Unwind_Trace_Fn回调，逐帧提取ip（instruction pointer） - 地址到符号的转换得靠
dladdr（<dlfcn.h>），它比backtrace_symbols更底层、更可靠，但不支持内联函数或模板实例化名 - 注意
_Unwind_Backtrace可能在 signal handler 中调用不安全（尤其 SIGSEGV 嵌套），建议仅用于主流程诊断，崩溃捕获优先用signal+sigaltstack配合
Windows 下用 CaptureStackBackTrace + SymFromAddr
Windows 没有 POSIX 兼容的 backtrace，原生方案是 Windows SDK 的 dbghelp.h：先用 CaptureStackBackTrace 拿地址，再用 SymFromAddr 查符号。它依赖 PDB 文件，且需提前调用 SymInitialize 初始化符号引擎。
容易踩的坑：SymFromAddr 默认不加载模块符号，若没调 SymLoadModule64 或未启用 SYMOPT_DEFERRED_LOADS，会返回 “not found”；另外，Release 版本若没生成 PDB 或路径不对，照样只能看到地址。
- 必须链接
dbghelp.lib，运行时依赖dbghelp.dll（WinXP SP2+ 自带） -
CaptureStackBackTrace最多支持 62 帧（参数限制），超长栈会截断 - 多线程下
SymInitialize应只调一次，且最好在主线程初始化
跨平台封装要注意符号解析的延迟与可靠性
真正写生产级 backtrace 工具时，最大的复杂点不是“怎么取地址”，而是“怎么把地址稳准快地转成可读函数名”。backtrace_symbols 在 glibc 下快但不可靠（strip 后失效）；dladdr 和 SymFromAddr 更健壮，但首次调用有明显延迟（要加载符号表）。
一个常被忽略的细节：C++ 函数名是 mangled 的，backtrace_symbols 和 dladdr 返回的都是 mangled 名（如 _Z12my_func_namev），想看可读名得额外调 abi::__cxa_demangle（Linux/macOS）或 UnDecorateSymbolName（Windows）。这个步骤不是免费的——demangle 一次可能耗时微秒级，高频日志里别每帧都做。
