【C++】手写线程安全队列:mutex + condition_variable 实现生产者消费者模型
前面已经分别介绍过互斥锁和条件变量。单独看这些知识点可能比较零散而线程安全队列正好可以把它们串起来。普通的std::queue并不是线程安全的std::queueint tasks;如果一个线程正在tasks.push(10);另一个线程同时tasks.pop();就可能发生数据竞争。因此我们希望封装一个这样的队列ThreadSafeQueueint queue; queue.push(100); int value; queue.wait_and_pop(value);其中push()可以被生产者线程调用wait_and_pop()可以让消费者在没有数据时自动等待。一、普通 queue 为什么不能直接多线程使用先来看一个简单例子#include queue #include thread std::queueint tasks; void Producer() { for (int i 0; i 1000; i) { tasks.push(i); } } void Consumer() { while (!tasks.empty()) { int value tasks.front(); tasks.pop(); } }如果生产者和消费者同时运行std::thread t1(Producer); std::thread t2(Consumer);它们可能同时访问tasks而std::queue本身不会自动加锁。例如消费者执行if (!tasks.empty())刚判断队列不为空生产者或其他消费者就可能修改队列。更典型的问题是if (!tasks.empty()) { int value tasks.front(); tasks.pop(); }这三步并不是一个不可分割的整体检查队列 ↓ 读取队首 ↓ 删除队首因此必须使用互斥锁保护整个操作过程。最简单的写法std::mutex mutex; void Push(int value) { std::lock_guardstd::mutex lock(mutex); tasks.push(value); }取数据时同样加锁bool Pop(int value) { std::lock_guardstd::mutex lock(mutex); if (tasks.empty()) { return false; } value tasks.front(); tasks.pop(); return true; }这样可以保证同一时刻只有一个线程修改队列。不过还有一个问题队列为空时消费者应该怎么办如果不停调用while (!Pop(value)) { }线程会一直空转占用 CPU。所以还需要condition_variable。二、先实现 push 和 try_pop我们先搭建一个基础线程安全队列#include condition_variable #include mutex #include queue templatetypename T class ThreadSafeQueue { public: void push(const T value) { { std::lock_guardstd::mutex lock(mutex_); queue_.push(value); } condition_.notify_one(); } bool try_pop(T value) { std::lock_guardstd::mutex lock(mutex_); if (queue_.empty()) { return false; } value queue_.front(); queue_.pop(); return true; } private: std::queueT queue_; std::mutex mutex_; std::condition_variable condition_; };先看void push(const T value)内部首先std::lock_guardstd::mutex lock(mutex_); queue_.push(value);保证多个生产者不能同时破坏队列内部结构。加入数据以后condition_.notify_one();通知一个正在等待数据的消费者队列中已经有新数据了可以起来检查了。这里故意把notify_one()放在锁作用域外{ std::lock_guardstd::mutex lock(mutex_); queue_.push(value); } condition_.notify_one();而不是std::lock_guardstd::mutex lock(mutex_); queue_.push(value); condition_.notify_one();后一种通常也能保证正确性但唤醒消费者以后消费者还需要重新获取mutex_。如果生产者此时仍然持有锁消费者被唤醒 ↓ 想获取mutex ↓ 生产者还没有释放 ↓ 消费者继续等待所以通常先完成共享数据修改并释放锁再进行通知会更自然。try_pop()则表示尝试取出一个数据如果当前没有数据就立即返回。bool try_pop(T value) { std::lock_guardstd::mutex lock(mutex_); if (queue_.empty()) { return false; } value queue_.front(); queue_.pop(); return true; }使用int value; if (queue.try_pop(value)) { std::cout value \n; } else { std::cout 队列为空\n; }它不会等待。因此try_pop()比较适合有任务就处理 没任务就去做其他事情而线程池工作线程通常需要的是没有任务就睡眠 有任务再醒来这就需要wait_and_pop()。三、wait_and_pop 为什么需要 unique_lock实现void wait_and_pop(T value) { std::unique_lockstd::mutex lock(mutex_); condition_.wait(lock, [this]() { return !queue_.empty(); }); value queue_.front(); queue_.pop(); }这里最重要的一句是condition_.wait(lock, [this]() { return !queue_.empty(); });它表示只要队列为空就继续等待队列不为空以后才继续向下执行。大致等价于while (queue_.empty()) { condition_.wait(lock); }假设队列为空消费者获得mutex_ ↓ 发现queue_为空 ↓ wait释放mutex_ ↓ 消费者睡眠之后生产者queue.push(100);内部执行获得mutex_ ↓ queue_.push(100) ↓ 释放mutex_ ↓ notify_one()消费者被唤醒重新获得mutex_ ↓ 再次检查queue_.empty() ↓ 发现不为空 ↓ 取出数据这里必须使用std::unique_lockstd::mutex而不是std::lock_guardstd::mutex因为wait()睡眠时需要临时unlock醒来以后还需要lockunique_lock支持这种灵活控制。因此std::unique_lockstd::mutex lock(mutex_); condition_.wait(lock, [this]() { return !queue_.empty(); });是线程安全队列中非常经典的一种写法。四、完整线程安全队列实现把几个接口组合起来#include condition_variable #include mutex #include queue templatetypename T class ThreadSafeQueue { public: ThreadSafeQueue() default; void push(const T value) { { std::lock_guardstd::mutex lock(mutex_); queue_.push(value); } condition_.notify_one(); } void push(T value) { { std::lock_guardstd::mutex lock(mutex_); queue_.push(std::move(value)); } condition_.notify_one(); } bool try_pop(T value) { std::lock_guardstd::mutex lock(mutex_); if (queue_.empty()) { return false; } value std::move(queue_.front()); queue_.pop(); return true; } void wait_and_pop(T value) { std::unique_lockstd::mutex lock(mutex_); condition_.wait(lock, [this]() { return !queue_.empty(); }); value std::move(queue_.front()); queue_.pop(); } bool empty() const { std::lock_guardstd::mutex lock(mutex_); return queue_.empty(); } size_t size() const { std::lock_guardstd::mutex lock(mutex_); return queue_.size(); } private: std::queueT queue_; mutable std::mutex mutex_; std::condition_variable condition_; };这里同时提供了两个push()void push(const T value); void push(T value);第一个处理左值int value 100; queue.push(value);第二个支持移动queue.push(100);或者std::string str hello; queue.push(std::move(str));取数据时也使用value std::move(queue_.front());避免某些较大对象发生不必要的复制。另外bool empty() const是const成员函数但里面需要锁住mutex_所以互斥锁声明为mutable std::mutex mutex_;mutable表示即使当前对象是const这个成员仍然允许修改。而加锁和解锁本身会修改 mutex 的内部状态所以需要mutable。五、生产者消费者完整示例下面创建两个生产者和两个消费者。#include iostream #include thread ThreadSafeQueueint queue; void Producer(int start) { for (int i 0; i 5; i) { int value start i; queue.push(value); std::cout 生产 value \n; } } void Consumer() { for (int i 0; i 5; i) { int value; queue.wait_and_pop(value); std::cout 消费 value \n; } } int main() { std::thread producer1(Producer, 100); std::thread producer2(Producer, 200); std::thread consumer1(Consumer); std::thread consumer2(Consumer); producer1.join(); producer2.join(); consumer1.join(); consumer2.join(); return 0; }生产者不断queue.push(value);消费者不断queue.wait_and_pop(value);如果队列中存在数据消费者直接取出如果队列为空消费者进入wait ↓ 释放mutex ↓ 进入睡眠生产者加入任务push数据 ↓ notify_one ↓ 消费者被唤醒这就是最基本的生产者—消费者模型。整个结构其实已经非常接近线程池中的任务队列外部线程 ↓ 提交任务 ↓ ThreadSafeQueue ↓ condition_variable通知 ↓ Worker线程醒来 ↓ wait_and_pop取任务 ↓ 执行任务如果把ThreadSafeQueueint改成ThreadSafeQueuestd::functionvoid()队列里面保存的就不再是数字而是一个个真正可以执行的任务ThreadSafeQueuestd::functionvoid() tasks;提交任务tasks.push([]() { std::cout 执行任务\n; });工作线程std::functionvoid() task; tasks.wait_and_pop(task); task();这样就已经搭出了一个简化线程池最核心的结构任务 ↓ 线程安全队列 ↓ condition_variable ↓ Worker ↓ 执行task()这一篇最需要掌握的是std::queue本身不保证线程安全 mutex负责保护队列内部数据 try_pop没有数据时立即返回 wait_and_pop没有数据时让线程睡眠 condition_variable负责通知等待线程 wait需要unique_lock因为等待期间必须释放mutex push完成数据修改后再notify_one 线程安全队列是生产者消费者模型和线程池的重要基础。0voice · GitHub

相关新闻

社会心理学视角下的祥和假象与危机预警机制

社会心理学视角下的祥和假象与危机预警机制

1. 标题背后的隐喻与现实映射"一片祥和的底下原来是暴风雨"这个充满诗意的标题,实际上揭示了当代社会普遍存在的一种现象——表面平静下暗藏危机。这种现象在心理学上被称为"平静假象效应",指的是人们倾向于展示和谐表象而隐藏真实矛…

2026/8/11 6:27:09 阅读更多 →
【C++】异步任务结果传递:promise、future 与 packaged_task

【C++】异步任务结果传递:promise、future 与 packaged_task

前面介绍了 condition_variable,解决的是“线程没有任务时如何等待,有任务时如何被唤醒”的问题。接下来还有一个很常见的问题: 子线程执行了一个任务以后,任务的返回值怎么交给主线程? 例如: int Add(int…

2026/8/11 6:27:09 阅读更多 →
智能问数POC验证方法论:八个必测场景,告别“demo好看上线翻车“

智能问数POC验证方法论:八个必测场景,告别“demo好看上线翻车“

摘要:传统智能问数/ChatBI的POC做法——准备50个"XX指标是多少"类问题统计准确率——已完全失效。本文提出面向新一代智能问数的POC验证方法论,包括八个必测场景(复杂归因、多轮追问、完整闭环、追问解释、纠错重测、多类型分析、数…

2026/8/11 6:27:09 阅读更多 →

最新新闻

高效文件命名与管理系统设计指南

高效文件命名与管理系统设计指南

1. 项目背景与需求分析最近在整理电脑文件时,发现一个特别有意思的现象:我的桌面上躺着十几个名为"无标题"的文档。这种情况相信很多朋友都遇到过,新建文档时随手保存,想着"待会儿再命名",结果一放…

2026/8/11 7:15:31 阅读更多 →
从 Demo 到生产:7 种 Agent 架构设计模式,帮你跨过落地鸿沟!

从 Demo 到生产:7 种 Agent 架构设计模式,帮你跨过落地鸿沟!

01 先说结论:Agent架构不是越复杂越好 在展开之前,先给三个判断: 架构没有绝对高低,只有适不适合 任务越简单,越应该优先用简单架构;任务越长、越复杂,才需要更多控制机制。 Agent 的核心演进方…

2026/8/11 7:15:31 阅读更多 →
刚性常微分方程组的现代数值解法与工程实践

刚性常微分方程组的现代数值解法与工程实践

1. 刚性常微分方程组的工程背景与数学特性刚性(Stiff)常微分方程组在工程实践中极为常见,特别是在涉及多时间尺度耦合的物理系统中。典型的应用场景包括:化学反应动力学(快速反应与慢速反应并存)电路瞬态分…

2026/8/11 7:15:31 阅读更多 →
SFT微调数据准备攻略:4种爆款格式一次讲透,轻松上手!

SFT微调数据准备攻略:4种爆款格式一次讲透,轻松上手!

准备 SFT 微调数据时,核心并不复杂:给模型一条任务,再准备一个希望它学会的标准答案。例如,想让模型学会把一句生硬的话改得更礼貌,就可以准备这样的训练数据: 用户输入:你这个文件写错了&#…

2026/8/11 7:15:31 阅读更多 →
复杂任务开发:如何撰写高质量Spec(规格说明书)指导AI Agent与技能开发

复杂任务开发:如何撰写高质量Spec(规格说明书)指导AI Agent与技能开发

1. 从“一团乱麻”到“清晰蓝图”:为什么复杂任务的 Spec 至关重要干了这么多年项目,无论是带团队攻坚,还是自己独立啃一个硬骨头,我越来越觉得,决定一个复杂任务最终是“优雅落地”还是“一地鸡毛”的,往往…

2026/8/11 7:15:31 阅读更多 →
从AI工具调用到思维重塑:职场人如何驾驭AI成为能力放大器

从AI工具调用到思维重塑:职场人如何驾驭AI成为能力放大器

1. 从“AI威胁论”到“AI赋能论”:一个行业老兵的观察最近,黄仁勋在毕业季的喊话——“AI不会取代你,但善用AI的人会”——又一次在圈内引发了广泛的讨论。作为一名在科技行业摸爬滚打了十多年的从业者,我目睹了从“大数据”到“云…

2026/8/11 7:14:31 阅读更多 →

日新闻

如何用Video2X实现专业级视频画质提升:AI视频增强完整指南

如何用Video2X实现专业级视频画质提升:AI视频增强完整指南

如何用Video2X实现专业级视频画质提升:AI视频增强完整指南 【免费下载链接】video2x A machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018. 项目地址: https://gitcode.com/GitHub_Trending/vi/v…

2026/8/11 0:00:02 阅读更多 →
前后端分离项目中控制台与接口工具数据差异排查指南

前后端分离项目中控制台与接口工具数据差异排查指南

1. 问题现象解析:控制台与Apifox的数据差异 最近在调试一个前后端分离项目时,遇到了一个典型问题:后端服务在本地开发环境控制台能正常输出查询数据,但通过Apifox测试时却返回空结果。这种"控制台有数据,接口工具…

2026/8/11 0:00:03 阅读更多 →
AI编程实战:从Claude Code踩坑到游戏开发入门

AI编程实战:从Claude Code踩坑到游戏开发入门

1. 从“AI能帮我做游戏”到“AI让我重新学编程”最近身边不少朋友,尤其是一些非技术背景、但对游戏开发有浓厚兴趣的朋友,都在问我同一个问题:“听说现在用Claude Code这种AI编程工具,小白也能做游戏了,是真的吗&#…

2026/8/11 0:00:03 阅读更多 →

周新闻

5分钟告别提取码焦虑:baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑:baidupankey如何智能破解百度网盘资源锁

5分钟告别提取码焦虑:baidupankey如何智能破解百度网盘资源锁 【免费下载链接】baidupankey 在线查询网盘提取码(维护中 rm repo) 项目地址: https://gitcode.com/gh_mirrors/ba/baidupankey 你是否曾经在深夜寻找一份重要资料&#x…

2026/8/11 1:08:05 阅读更多 →
如何快速生成中国车牌图片:Python开源工具完整指南

如何快速生成中国车牌图片:Python开源工具完整指南

如何快速生成中国车牌图片:Python开源工具完整指南 【免费下载链接】chinese_license_plate_generator 中国车牌生成器 项目地址: https://gitcode.com/gh_mirrors/ch/chinese_license_plate_generator 中国车牌生成器是一个基于Python的开源项目&#xff0c…

2026/8/11 1:08:05 阅读更多 →
收藏!小白程序员轻松入门大模型,从Harness工程开始实践

收藏!小白程序员轻松入门大模型,从Harness工程开始实践

文章强调学习大模型不应只关注模型本身,而应重视模型外的系统搭建,即Harness。提出AgentModelHarness的实用公式,详细介绍Harness的四个层次:持久化层、执行层、控制层和观察与验证层。文章还探讨了上下文工程、工具设计、AGENTS.…

2026/8/11 1:08:05 阅读更多 →

月新闻

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南

免费解锁百度网盘SVIP加速:macOS用户必备的下载提速终极指南 【免费下载链接】BaiduNetdiskPlugin-macOS For macOS.百度网盘 破解SVIP、下载速度限制~ 项目地址: https://gitcode.com/gh_mirrors/ba/BaiduNetdiskPlugin-macOS 还在为百度网盘macOS版的龟速下…

2026/8/10 17:07:33 阅读更多 →
终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换

终极ncmdump指南:3分钟实现网易云NCM音乐解密与格式转换 【免费下载链接】ncmdump 项目地址: https://gitcode.com/gh_mirrors/ncmd/ncmdump 还在为网易云音乐下载的NCM格式文件无法在其他播放器播放而烦恼吗?ncmdump解密工具帮你轻松解决这个困…

2026/8/11 1:08:06 阅读更多 →
HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

HarmonyOS 应用开发《掌上英语》第81篇: 智能体卡片:为英语学习 App 打造桌面级学习助手

AgentCard 智能体卡片:为英语学习 App 打造桌面级学习助手适用平台:HarmonyOS 7.0 (API 26 Beta)一、引言 HarmonyOS 7.0(API 26 Beta)新增了 AgentCard 智能体卡片能力,这是继 HMAF(鸿蒙智能体框架&#x…

2026/8/10 17:07:33 阅读更多 →