libunwind 初始化需先调用 unw_getcontext(&uc) 获取寄存器上下文，再用 unw_init_local(&cursor, &uc) 初始化游标；逐帧提取需用 unw_get_reg 获取IP，dladdr查符号，abi::__cxa_demangle解码；多线程远程回溯依赖ptrace权限且目标线程须暂停；栈帧缺失常因-O2优化或缺-g调试信息导致。
libunwind 怎么初始化并获取当前线程的调用栈
libunwind 的核心是 unw_getcontext + unw_init_local，不是直接“抓”栈，而是通过寄存器上下文重建调用链。必须先捕获当前 CPU 上下文（含 RIP/RSP 等），再交给 libunwind 解析。
常见错误：跳过 unw_getcontext 直接调 unw_init_local，会导致栈帧解析失败或返回 0 帧；或者传入未初始化的 unw_cursor_t 变量。
- 务必用
unw_getcontext(&uc)获取上下文，&uc是unw_context_t类型变量 - 再用
unw_init_local(&cursor, &uc)初始化游标，&cursor是unw_cursor_t - 后续所有
unw_step、unw_get_reg都依赖这个已初始化的cursor
怎么逐帧提取函数地址和符号名（含 demangle）
libunwind 默认只给指令指针（IP），不带符号信息。要拿到函数名，得自己查符号表（如 dladdr）再做 C++ name demangling；否则看到的全是十六进制地址。
典型陷阱：直接对 IP 调 abi::__cxa_demangle 会崩溃——因为 IP 不是 mangled symbol 字符串，而是地址。必须先用 dladdr 拿到 Dl_info 中的 dli_sname。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 每帧调
unw_get_reg(&cursor, UNW_REG_IP, &ip)获取返回地址 - 用
dladdr((void*)ip, &info)查符号，成功时info.dli_sname是 mangled 名 - 再用
abi::__cxa_demangle(info.dli_sname, nullptr, nullptr, &status)解析，status == 0才有效 - 别忘了
free()demangle 返回的指针
多线程环境下怎么安全抓其他线程的堆栈
libunwind 的 unw_init_remote 支持跨线程回溯，但前提是你能访问目标线程的寄存器状态——这通常需要 ptrace(PTRACE_ATTACH) 权限，且目标线程必须被暂停（ptrace(PTRACE_GETREGS) 后才能构造上下文）。
普通用户态程序几乎无法安全做到：没有 ptrace 权限会被拒绝；强行 attach 会干扰目标线程甚至触发 SIGSTOP；glibc 的 pthread_kill 发信号再自陷的方式也不可靠（信号可能被屏蔽或延迟）。
- 生产环境推荐改用
libbacktrace或boost::stacktrace，它们不依赖 ptrace - 若坚持用 libunwind 远程，需确保进程有
CAP_SYS_PTRACE或以 root 运行 - 千万别在 signal handler 里对非当前线程调
unw_init_remote—— 寄存器上下文不可靠
为什么有时只能拿到 1–2 帧，或者报 UNW_EBADREG
最常见原因是编译时没关优化或没加调试信息：-O2 下编译器内联、尾调用、栈帧省略会让 libunwind 找不到合法帧边界；而缺少 -g 时，.eh_frame 或 .debug_frame 段缺失，导致 unwind 信息不足。
另一个隐蔽坑：使用 __attribute__((noinline)) 只影响当前函数，不影响调用链上游；真正要保帧，得在关键路径上整体控制编译选项。
- 调试阶段务必加
-g -O0编译，验证回溯逻辑 - 发布版可保留
-g（不增加运行时开销），仅去掉-O2或改用-Og - 检查是否链接了
-lunwind，且运行时LD_LIBRARY_PATH包含对应 so 路径 -
UNW_EBADREG往往意味着游标已越界或寄存器读取失败，优先检查unw_init_local返回值
libunwind 的脆弱性藏在细节里：寄存器上下文、符号表一致性、编译选项协同、权限模型——任何一个环节断掉，栈就断在半路。别指望一次配置跑通所有场景。
