<p>最小可行路径需三步：编译带调试信息（-g -O2 -fno-omit-frame-pointer）、perf record -F 99 -g -- ./prog 录制、perf script | stackcollapse-perf.pl --all-user | flamegraph.pl > flame.svg 渲染。</p>
perf + FlameGraph 生成 C++ 火焰图的最小可行路径
能，但“一键”是错觉——真正可复用的流程需要三步：编译带调试信息、用 perf 录制、用 FlameGraph 渲染。缺一不可，且任意一步出问题都会导致火焰图空白或失真。
常见错误现象：perf script 输出全是 [unknown]，或者火焰图里只有 __libc_start_main 一层；根本原因是没开调试符号或没关编译优化干扰栈展开。
- 编译时必须加
-g（生成 DWARF），推荐同时加-O2 -fno-omit-frame-pointer——-O2保留合理性能，-fno-omit-frame-pointer是 perf 解析调用栈的硬性依赖 - 运行前确保内核支持 perf event，普通用户需有
/proc/sys/kernel/perf_event_paranoid≤ 2（默认通常是 2，不用改；若为 3 则需临时降权：sudo sysctl -w kernel.perf_event_paranoid=2） - 录制命令别用
perf record -g就完事，要显式指定采样频率和目标：perf record -F 99 -g -- ./your_program，-F 99避免过载，--防止参数被 perf 解析错
为什么 perf script 输出里没有函数名？
不是 perf 坏了，是符号没加载进来。C++ 模板、内联函数、LTO 编译都可能让符号丢失或混淆，但最常踩的坑就两个：没 -g，或程序是 strip 过的。
使用场景：你改完代码重新编译，但忘了 clean 旧二进制，结果 perf 还在读带符号的老版本，而新运行的是无符号的；或者 CI 构建流程里自动 strip 了产物。
立即学习“C++免费学习笔记（深入）”；
- 验证符号是否存在：
readelf -S your_program | grep debug—— 应该看到多个.debug_*section - 检查是否被 strip：
file your_program输出里不能含stripped - 如果用了 CMake，确认
CMAKE_BUILD_TYPE是Debug或RelWithDebInfo，后者在-O2下仍保留调试信息
FlameGraph 渲染失败或图形扁平？
大概率是 perf script 输出格式不对，或折叠脚本没匹配上 C++ 符号规则。原生 perf script 输出的栈是逆序的（leaf 在上），而 FlameGraph 要求正序（root 在上），中间必须用 stackcollapse-perf.pl 转换。
性能影响：不加 --all-user 或 --kernel 过滤，perf record 会混入内核路径，大幅拖慢渲染且干扰主线程热点识别。
- 标准流水线：
perf script | ./stackcollapse-perf.pl --all-user | ./flamegraph.pl > flame.svg - 如果 C++ 函数名带模板参数太长导致 SVG 渲染卡顿，加
--max-width 10000参数给flamegraph.pl（默认只截前100字符） - 避免用
perf report替代perf script—— 前者是交互式查看器，输出非结构化文本，不能喂给 FlameGraph
Clang 用户注意 libunwind 和 libdw 的兼容性陷阱
perf 默认用 libdw（来自 elfutils）解析 DWARF，但 Clang 编译的某些二进制（尤其启用了 -fstandalone-debug 或 LTO）可能依赖 libunwind 栈展开。两者不兼容时，-g 也救不了。
容易被忽略的地方：你本地开发机用 GCC 编译没问题，但上线环境是 Clang + LTO，perf record -g 就只能捕到用户态入口，看不到任何 C++ 函数。
- 验证方式：
perf record -g --call-graph dwarf,1024 ./your_program—— 显式启用 dwarf 模式，比默认的fp（frame pointer）更鲁棒 - 若仍失败，临时回退到
fp模式并确保编译加了-fno-omit-frame-pointer，这是最稳的兜底方案 - 不要指望
llvm-profdata或llvm-symbolizer直接对接 perf；它们属于 LLVM 的 profile 工具链，和 perf 生态不互通
