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
<h3>macOS 上 <code>backtrace</code> 不可用，改用 <code>_Unwind_Backtrace</code>
</h3>
<p>macOS 的 libc 不提供 <code>backtrace</code>，直接调用会链接失败（<code>undefined symbol: backtrace</code>）。必须切换为基于 libunwind 的方案，<code>_Unwind_Backtrace</code> 是系统级稳定接口，Xcode 自带，无需额外依赖。</p>
<p>使用场景：跨平台 C++ 日志/崩溃捕获模块，在 macOS 上不能简单 #ifdef 跳过，必须提供等效实现。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>需要自己实现 <code>_Unwind_Trace_Fn</code> 回调，逐帧提取 <code>ip</code>（instruction pointer）</li>
<li>地址到符号的转换得靠 <code>dladdr</code>（<code><dlfcn.h></dlfcn.h></code>），它比 <code>backtrace_symbols</code> 更底层、更可靠，但不支持内联函数或模板实例化名</li>
<li>注意 <code>_Unwind_Backtrace</code> 可能在 signal handler 中调用不安全（尤其 SIGSEGV 嵌套），建议仅用于主流程诊断，崩溃捕获优先用 <code>signal</code> + <code>sigaltstack</code> 配合</li>
</ul>
<h3>Windows 下用 <code>CaptureStackBackTrace</code> + <code>SymFromAddr</code>
</h3>
<p>Windows 没有 POSIX 兼容的 <code>backtrace</code>，原生方案是 Windows SDK 的 <code>dbghelp.h</code>：先用 <code>CaptureStackBackTrace</code> 拿地址，再用 <code>SymFromAddr</code> 查符号。它依赖 PDB 文件，且需提前调用 <code>SymInitialize</code> 初始化符号引擎。</p>
<p>容易踩的坑：<code>SymFromAddr</code> 默认不加载模块符号，若没调 <code>SymLoadModule64</code> 或未启用 <code>SYMOPT_DEFERRED_LOADS</code>，会返回 “not found”；另外，Release 版本若没生成 PDB 或路径不对，照样只能看到地址。</p>
<ul>
<li>必须链接 <code>dbghelp.lib</code>，运行时依赖 <code>dbghelp.dll</code>（WinXP SP2+ 自带）</li>
<li>
<code>CaptureStackBackTrace</code> 最多支持 62 帧（参数限制），超长栈会截断</li>
<li>多线程下 <code>SymInitialize</code> 应只调一次，且最好在主线程初始化</li>
</ul>
<h3>跨平台封装要注意符号解析的延迟与可靠性</h3>
<p>真正写生产级 backtrace 工具时，最大的复杂点不是“怎么取地址”，而是“怎么把地址稳准快地转成可读函数名”。<code>backtrace_symbols</code> 在 glibc 下快但不可靠（strip 后失效）；<code>dladdr</code> 和 <code>SymFromAddr</code> 更健壮，但首次调用有明显延迟（要加载符号表）。</p>
<p>一个常被忽略的细节：C++ 函数名是 mangled 的，<code>backtrace_symbols</code> 和 <code>dladdr</code> 返回的都是 mangled 名（如 <code>_Z12my_func_namev</code>），想看可读名得额外调 <code>abi::__cxa_demangle</code>（Linux/macOS）或 <code>UnDecorateSymbolName</code>（Windows）。这个步骤不是免费的——demangle 一次可能耗时微秒级，高频日志里别每帧都做。</p></stdlib.h></stdio.h></execinfo.h>C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
