__builtin_expect 是 GCC/Clang 提供给编译器的分支预测提示，非魔法，仅在热点路径、条件高度偏斜且 CPU 分支预测器强时可能提升性能；误用（如传非常量、副作用表达式、类型错误）会导致编译失败或逻辑错误，应谨慎实测验证。
__builtin_expect 是什么，它真能提升性能？
它不是魔法，只是给编译器一个“这个分支大概率走哪边”的提示。GCC/Clang 会据此调整生成的汇编顺序（比如把 likely 分支放在紧跟 jmp 后面的位置），减少 CPU 分支预测失败带来的流水线冲刷。但效果高度依赖场景：热点路径上、条件极偏斜（比如错误处理只在 0.001% 情况触发）、且目标 CPU 有较强分支预测器时才可能测出差异；普通 if 或随机分布分支加了反而可能变慢。
怎么写才不白加：括号、类型、常量值必须严格匹配
__builtin_expect 只接受两个参数：expr 和 likely_value，且后者必须是编译期常量整数。常见翻车点：
- 传变量或宏展开后非字面量的值 → 编译报错：
error: second argument must be a constant integer - 表达式本身带副作用（如
__builtin_expect(x++, 1)）→x会被求值两次（一次用于判断，一次用于后续逻辑），结果错乱 - 误写成
__builtin_expect(condition, true)→true不是整数字面量，得用1或0 - 和
if搭配时漏掉外层括号 →if (__builtin_expect(x > 0, 1) == 1)比if (__builtin_expect(x > 0, 1))多一次比较，白费力气
正确姿势：if (__builtin_expect(x > 0, 1)) {……} 或封装成宏：#define likely(x) __builtin_expect(!!(x), 1)
哪些地方加了反而拖后腿？
不是所有 if 都适合套 __builtin_expect：
立即学习 “C++ 免费学习笔记（深入）”；
- 循环内频繁执行、但分支概率接近 50/50 的判断（如遍历数组时
if (arr[i] & 1)）→ 预测器本来就能跟上，加了没收益还增加指令长度 - 函数入口的参数校验（如
if (!ptr)），如果调用方几乎总传合法指针，这里加__builtin_expect(ptr, 1)有意义；但如果该函数被多处调用、有的地方常传空指针，提示就失效甚至误导 - 调试构建（
-O0）下该内置函数被忽略，但代码仍要编译通过 → 别依赖它做逻辑控制，它只是优化提示 - 跨平台代码（MSVC 不支持）→ 必须用宏包裹，否则 Linux 编译过、Windows 直接炸
验证有没有效果，别靠猜
加完不能只看编译是否通过，得实测：
- 用
perf stat -e branches,branch-misses ./a.out对比加前加后分支失误率，下降 5%+ 才算有效果 - 关注实际耗时（
time或高精度计时），尤其在热点函数里跑百万次迭代；单纯看 IPC 或 cycle 数容易受干扰 - 换不同 CPU（比如 Skylake vs Zen3）再测一遍 —— 分支预测器设计不同，收益可能差 3 倍
- 开启
-O2或更高优化级，且确认未被-fno-tree-loop-distribute-patterns等开关抑制相关优化
真正影响性能的，往往是缓存局部性、指令级并行度或内存访问模式，__builtin_expect 只在分支预测成为瓶颈时才露一手。多数人花十分钟写的 if，不如花十分钟看一眼 perf report 里 hottest function 是哪个。
