std::call_once不能直接传裸函数对象（如带捕获lambda左值），因模板推导易失败；必须用无捕获lambda、函数指针、static成员或显式std::function包装，且std::once_flag须为static/全局。
std::call_once 为什么不能直接传函数对象？
因为 std::call_once 要求第一个参数是 std::once_flag&，第二个及之后的参数会被完美转发给目标可调用对象——但它**不接受裸函数对象（如 lambda）作为左值引用传入**。常见错误是写成：
auto f = []{ /*...*/ };<br>std::call_once(flag, f); // ❌ 编译失败：无法绑定右值到 const std::function&根本原因是 lambda 类型每次都是唯一的，且默认不可拷贝（尤其带捕获时），而 std::call_once 内部模板推导会尝试按值或引用传递，容易触发类型不匹配。
正确做法是显式转成 std::function 或直接传临时 lambda：
- 无捕获 lambda：直接传
[]{}，编译器能推导出函数指针类型，安全 - 有捕获 lambda：必须包装成
std::function<void></void>，否则报错no matching function for call to 'call_once' - 普通函数指针或静态成员函数：可直接传，无需包装
std::once_flag 必须是 static 或全局，不能是局部自动变量
这是最常踩的坑。std::once_flag 内部依赖状态位做原子标记，如果每次调用都新建一个局部 std::once_flag，那每次都是“全新未执行”状态，std::call_once 就永远只执行一次——但那是**每次调用都执行一次**，完全违背“整个程序生命周期只执行一次”的本意。
典型错误写法：
void unsafe_init() {<br> std::once_flag flag; // ❌ 每次调用都新建<br> std::call_once(flag, []{ init_global_resource(); });<br>}正确方式只有两种：
立即学习“C++免费学习笔记（深入）”；
-
static std::once_flag flag;—— 最常用，作用域内首次调用后永久标记 - 全局或类静态成员变量 —— 适合跨函数/跨类共享初始化逻辑
注意：std::once_flag 不可拷贝、不可移动，也不能用 new 动态分配后传引用（易悬垂）。
异常发生时 std::call_once 会重试吗？
不会重试，但会保证「最多执行一次」。如果被调用的函数抛出异常，std::call_once 会捕获并传播该异常，同时**不标记该 std::once_flag 为已完成**。后续再次调用时，仍会尝试执行——这可能导致多次异常，也可能在某次成功执行后才真正完成。
这意味着：如果你的初始化逻辑可能失败（比如文件读取、网络请求），必须自己处理异常，否则调用方要准备反复 catch。常见对策：
- 在 lambda 内吞掉异常，改用返回码或原子标志记录失败状态
- 把关键资源初始化拆成「预检查 + 真实初始化」两步，检查失败就提前 return
- 避免在
std::call_once中做不可逆操作（如 malloc 后没 free 就抛异常）
例如：
static std::once_flag flag;<br>static bool init_succeeded = false;<br>std::call_once(flag, []{<br> try {<br> risky_init();<br> init_succeeded = true;<br> } catch (...) {<br> init_succeeded = false;<br> }<br>});
和 std::mutex + 手动 flag 比，性能差多少？
在绝大多数场景下，std::call_once 的性能优于手写 double-checked locking。它底层通常基于原子操作 + futex（Linux）或类似原语，首次竞争时开销略高（需原子 CAS + 可能线程挂起），但一旦完成，后续调用几乎就是一次原子 load，比加锁解锁快一个数量级。
不过要注意两个边界情况：
- 如果初始化函数本身极快（比如只赋几个变量），手写
if (!inited) { lock(); if (!inited) { ... } }可能略快——但可读性和安全性差太多，不推荐 - 频繁调用
std::call_once（比如每毫秒一次）且初始化早已完成，现代 libstdc++/libc++ 实现已足够优化，不必担心
真正要警惕的是误用：比如把 std::once_flag 放在栈上、或在 hot path 里反复构造 std::function 包装器——这些开销远大于 std::call_once 本身。
