当前位置：首页 > news >正文

C++11 std::call_once 核心用法与高并发场景实战

news 2026/5/12 13:26:12

在 C++ 多线程开发中，全局 / 单例对象的一次性初始化是高频痛点：多个线程同时触发初始化，极易导致资源重复创建、逻辑异常甚至程序崩溃。

C++11 提供的std::call_once就是专门解决这类问题的标准工具，它能保证指定函数在多线程环境下绝对只执行一次，是线程安全初始化的最优方案。

本文结合最常用的线程安全单例模式，带你彻底掌握std::call_once的原理、用法与最佳实践。

一、多线程下单例模式的安全隐患

单例模式的核心要求：类有且仅有一个实例，并提供全局访问点。

传统懒汉式单例（静态局部变量）在 C++11 之前并非线程安全，多线程高并发场景下会出现：

多个线程同时进入初始化流程
实例被重复创建，破坏单例约束
资源泄漏、数据竞争等未定义行为

即使现代编译器对静态局部变量做了线程安全优化，在更复杂的初始化逻辑（多步骤、依赖其他资源）中，依然需要更通用、可控的方案。

二、std::call_once 核心介绍

std::call_once是 C++11 标准库提供的线程安全一次性执行函数，搭配std::once_flag使用，可保证：

多线程并发调用时，目标函数只执行一次
未执行完的线程会阻塞等待，不会提前返回
无额外性能开销，比互斥锁更轻量高效
跨平台兼容，无需编写平台相关逻辑

函数原型

template<class Callable, class... Args> void call_once(once_flag& flag, Callable&& func, Args&&... args);

关键参数

std::once_flag：标记位，必须是全局 / 静态变量，用于记录函数是否已执行
func：需要只执行一次的函数 / 可调用对象
args：传递给函数的参数（可选）

三、实战：std::call_once 实现线程安全单例

下面是工业级可用的线程安全单例实现，完全基于 C++11 标准，无任何第三方依赖。

完整代码

#include <iostream> #include <memory> #include <mutex> #include <thread> // 线程安全单例类 class Singleton { public: // 获取单例实例（全局唯一入口） static Singleton& get_instance() { // 保证 init 函数仅被执行一次 std::call_once(once_flag_, &Singleton::init); return *instance_ptr_; } // 业务方法：设置数据 void set_value(int value) { data_ = value; } // 业务方法：获取数据 int get_value() const { return data_; } // 禁用拷贝与赋值（单例禁止复制） Singleton(const Singleton&) = delete; Singleton& operator=(const Singleton&) = delete; private: // 私有构造：禁止外部创建对象 Singleton() = default; // 初始化函数：仅执行一次 static void init() { instance_ptr_.reset(new Singleton()); } // 静态成员变量 static std::unique_ptr<Singleton> instance_ptr_; static std::once_flag once_flag_; int data_ = 0; }; // 静态变量初始化 std::unique_ptr<Singleton> Singleton::instance_ptr_; std::once_flag Singleton::once_flag_; // 多线程测试函数 void test_task() { // 获取单例 Singleton& single = Singleton::get_instance(); // 输出当前线程ID + 对象地址（验证唯一） std::printf("线程ID: %zu | 单例地址: %p\n", std::hash<std::thread::id>{}(std::this_thread::get_id()), &single); } int main() { std::cout << "===== 多线程测试线程安全单例 =====" << std::endl; // 创建 5 个线程并发获取单例 std::thread t1(test_task); std::thread t2(test_task); std::thread t3(test_task); std::thread t4(test_task); std::thread t5(test_task); t1.join(); t2.join(); t3.join(); t4.join(); t5.join(); return 0; }