PGO是基于真实运行路径的编译优化技术，能为中大型C++程序带来5%–15%性能提升；需三阶段执行：插桩编译、代表性运行采集、重编译优化，clang/msvc/gcc均支持但细节差异大。
PGO 是什么，为什么 C++ 项目值得试它
PGO 不是银弹，但对中大型 C++ 程序（尤其是启动慢、热点集中的服务或 CLI 工具）能稳定带来 5%–15% 的性能提升——不是靠猜，而是靠真实运行路径做优化决策。clang 和 msvc 都支持，gcc 也行但流程更糙。关键在于：它不改变你写的代码逻辑，只让编译器更懂哪些分支常走、哪些函数该内联、哪些冷代码可以挪到远端内存页。
用 clang 做 PGO：三步不能少，漏一步就白跑
clang 的 PGO 分三阶段：插桩编译 → 运行采集 → 重编译。最容易错在第二步——没跑出有代表性的 profile 数据。
-
clang++ -fprofile-instr-generate -O2 main.cpp -o app：生成带插桩的可执行文件，注意必须加-O2或更高，否则插桩无效 - 用典型输入跑它：
./app /dev/null；别只跑一次，多组输入、覆盖主流程和异常分支，否则default.profraw里全是零值 -
llvm-profdata merge -output=default.profdata default.profraw，再clang++ -fprofile-instr-use=default.profdata -O2 main.cpp -o app-opt
常见错误：profdata merge 报 “no data” —— 本质是插桩没触发，检查是否用了 -O0 编译第一遍，或者程序提前 exit 了没来得及 flush 插桩计数器。
MSVC 下 PGO：/LTCG 必须开，否则 profile 信息被丢掉
Visual Studio 默认关掉链接时代码生成（/LTCG），但 PGO 在 MSVC 中依赖它传递 profile 元数据。不开就等于只跑了第一遍，后两步全失效。
立即学习“C++免费学习笔记（深入）”；
- 第一遍：项目属性 → C/C++ → 优化 → 启用 PGO → “仅生成”；同时链接器 → 优化 → 启用链接时间代码生成 → “是”
- 运行
app.exe采集，会生成app.pgd（不是 .profraw） - 第二遍：启用 PGO → “使用”，再编译；此时
/LTCG仍需保持开启，否则链接器看不到 profile 数据
坑点：VS GUI 里改完设置要“全部重新生成”，增量编译可能复用旧 obj，导致 profile 信息不一致；另外 app.pgd 文件权限若被 IDE 锁住，第二次编译会静默失败，看输出窗口有没有 “PGD file not found” 提示。
gcc 的 PGO：-fprofile-generate 和 -fprofile-use 不兼容不同版本 GCC
gcc 的 PGO 对工具链一致性要求最严——生成 profile 的 gcc 版本、合并 gcda 的版本、最终优化编译的版本，必须完全一致（包括 patch 号）。混用 12.2 和 12.3 就可能报 corrupted counter data。
-
g++ -fprofile-generate -O2 main.cpp -o app：注意不是-fprofile-arcs（那是老式 gcov 路线） - 运行后生成
app.gcda，不是单个文件，而是一堆按源文件路径组织的二进制数据 -
g++ -fprofile-use -O2 main.cpp -o app-opt：必须确保当前工作目录下有完整的.gcda树，且 gcc 版本一字不差
容易被忽略的是：如果项目用 CMake，CMAKE_CXX_FLAGS 里加了 -fprofile-generate，但没清掉 build 目录里的旧 .o，这些 obj 里没插桩，链接时 profile 数据就断层了。
PGO 真正难的不是命令怎么敲，而是设计采集场景——拿线上 1% 流量 dump 出来的 trace，比本地手写 10 个 test case 更有效；还有，profile 数据一旦过期（比如业务逻辑大改），优化反而拖慢，得定期重采。
