前言线程池thread pool要解决的问题很具体频繁地创建和销毁线程是有代价的。每次std::thread构造都要向操作系统申请内核对象和栈空间销毁时要回收任务本身却可能只执行几微秒。当任务数量远大于 CPU 核心数时为每个任务开一个线程还会让调度器忙于切换缓存局部性变差。线程池的思路是预先创建固定数量的工作线程让它们从一个共享队列里取任务执行把「线程的生命周期」和「任务的生命周期」解耦。关于线程池最常见的误解有三个。第一认为线程数越多吞吐越高——实际上超过硬件并发度之后额外线程只会增加上下文切换和内存占用对 CPU 密集型任务没有帮助。第二认为「无锁队列一定更快」——在竞争激烈时自旋和 CAS 失败重试的代价可能超过一把短临界区的互斥量而且无锁队列的正确性极难保证。第三认为线程池能自动解决数据竞争——池只负责调度任务之间共享数据的同步仍然要由调用者负责。本文按「为什么需要 → 由哪些部件组成 → 完整实现 → 关闭与异常边界」的顺序讲解给出一个基于 C17 标准库、可直接放进项目的线程池并逐条列出实现中最容易踩的坑。文中所有代码都只按标准语义推演本机没有编译器不声称任何执行结果。一、线程池的组成部件一个最小可用的线程池由四部分组成。工作线程集合一组长期存活的std::thread每个线程运行同一个循环函数。任务队列存放待执行任务的容器通常是std::queuestd::functionvoid()。类型擦除让不同签名的任务能排进同一个队列。同步原语一把std::mutex保护队列一个std::condition_variable在队列为空时挂起工作线程。停止标志告诉工作线程「不会再有新任务」让它们把剩余任务做完后退出。工作线程的主循环可以概括成一句话加锁、在条件变量上等待「有任务或要停止」、取一个任务、解锁、执行。解锁必须在执行任务之前完成否则所有工作线程会被串行化线程池退化成单线程。这里有一个关键设计点队列里存什么。如果只存std::functionvoid()调用者拿不到返回值也拿不到异常。标准库给出的答案是std::packaged_taskR()它把可调用对象包装成一个任务内部持有一个共享状态关联一个std::futureR。任务执行时返回值或异常被写进共享状态调用者通过 future 取回。线程池只需要把packaged_task再包一层成void()塞进队列即可。二、任务提交与类型推导提交接口通常是可变参数模板template class F, class... Argsauto submit(F f, Args... args) - std::futurestd::invoke_result_tF, Args...;返回类型用std::invoke_result_tF, Args...推导C17 起可用C11/14 用std::result_of_t后者在 C17 弃用、C20 移除。std::invoke_result比decltype(f(args...))更准确因为它同时支持普通可调用对象、函数指针和指向成员的指针。参数如何绑定到任务上有两种写法。第一种是std::bind(std::forwardF(f), std::forwardArgs(args)...)第二种是 lambda 捕获。lambda 的完美转发捕获[f std::forwardF(f), ...]这种包展开需要 C20C17 下写不出来所以本文用std::bind。但必须知道std::bind的两个限制它按值 decay-copy 所有实参引用语义要用std::ref显式表达它要求被绑定的可调用对象和实参都是可拷贝构造的因此 move-only 的捕获比如std::unique_ptr不能直接走这条路。如果项目里大量使用 move-only 捕获更稳妥的做法是让submit直接接收一个已经绑定好的std::functionvoid()或无参 lambda。还有一个容易忽略的点std::bind返回的对象在调用时并不会保留实参的值类别传进来的右值在绑定那一刻就被移动或拷贝进了 bind 的存储。这对大多数任务没有影响但如果任务内部依赖引用语义修改外部变量必须写std::ref(x)。三、完整实现下面是一个完整版本包含构造、提交、工作循环和优雅关闭。// 适用于 C17#include condition_variable#include functional#include future#include mutex#include queue#include stdexcept#include thread#include type_traits#include utility#include vectorclass ThreadPool {public:explicit ThreadPool(std::size_t n std::thread::hardware_concurrency()): stop_(false) {if (n 0) n 1; // hardware_concurrency 可能返回 0workers_.reserve(n);for (std::size_t i 0; i n; i) {workers_.emplace_back([this] { workerLoop(); });}}~ThreadPool() { shutdown(); }ThreadPool(const ThreadPool) delete;ThreadPool operator(const ThreadPool) delete;template class F, class... Argsauto submit(F f, Args... args)- std::futurestd::invoke_result_tF, Args... {using R std::invoke_result_tF, Args...;auto bound std::bind(std::forwardF(f), std::forwardArgs(args)...);auto task std::make_sharedstd::packaged_taskR()(std::move(bound));std::futureR fut task-get_future();{std::lock_guardstd::mutex lk(mtx_);if (stop_) {throw std::runtime_error(submit on a stopped ThreadPool);}// 类型擦除packaged_taskR() 不能直接放进 void() 的队列tasks_.emplace([task] { (*task)(); });}cv_.notify_one();return fut;}void shutdown() {{std::lock_guardstd::mutex lk(mtx_);if (stop_) return;stop_ true;}cv_.notify_all();for (auto t : workers_) {if (t.joinable()) t.join();}}private:void workerLoop() {for (;;) {std::functionvoid() job;{std::unique_lockstd::mutex lk(mtx_);cv_.wait(lk, [this] { return stop_ || !tasks_.empty(); });if (stop_ tasks_.empty()) return; // 停止且已排空job std::move(tasks_.front());tasks_.pop();} // 先解锁job(); // 再执行}}std::vectorstd::thread workers_;std::queuestd::functionvoid() tasks_;std::mutex mtx_;std::condition_variable cv_;bool stop_;};几个细节值得展开。为什么stop_不用std::atomicbool。它只在持锁时读写锁已经提供了同步普通bool就够。若改成原子变量而仍然在锁外读就必须自己保证「检查停止标志」和「检查队列」这两步之间不出现竞态反而更容易写错。为什么用std::make_sharedstd::packaged_taskR()。packaged_task不可拷贝而std::function要求目标可拷贝。把它放进shared_ptrlambda 捕获的是这个指针拷贝的是指针本身任务对象仍然只有一份。make_shared让控制块和对象一次分配比shared_ptr(new ...)少一次分配也让异常安全性更好。等待谓词为什么是stop_ || !tasks_.empty()。条件变量存在虚假唤醒spurious wakeup不带谓词的wait返回后条件未必成立。带谓词的重载会在内部循环只有谓词为真才返回这是标准库推荐写法。为什么shutdown里要notify_all而不是notify_one。停止信号是广播性质的所有工作线程都要醒来检查stop_只唤醒一个会让其余线程永远睡在条件变量上join随之卡死。四、关闭语义与返回值关闭有两种常见语义。第一种是「排空后退出」已经入队的任务全部执行完再结束上面的实现就是这种判断条件是stop_ tasks_.empty()。第二种是「立即丢弃」清空队列直接退出适合取消场景。两者没有对错但必须在文档里写清楚否则调用者无法预期析构要花多久。如果某个任务会阻塞很久等待网络、等待另一个池的任务排空式关闭就会让析构函数长时间阻塞。因此生产代码常常再加一个std::atomicbool cancelled_让长任务自己检查取消标志。返回值路径是这样的packaged_task::get_future()在提交线程调用拿到std::futureR任务在工作线程执行时把结果写进共享状态调用线程fut.get()阻塞直到结果就绪。如果任务抛出异常packaged_task会捕获它并存入共享状态get()重新抛出——这一点很重要它意味着工作者线程不会因为任务异常而std::terminate。但前提是任务确实被packaged_task包着。如果队列里存的是裸std::function且直接调用job()异常会逃出workerLoop而线程函数抛出未捕获异常会调用std::terminate。使用示例如下。// 适用于 C17#include iostream#include stringint main() {ThreadPool pool(4);auto sum pool.submit([](int a, int b) { return a b; }, 2, 3);auto text pool.submit([] { return std::string(hello); });auto boom pool.submit([]() - int { throw std::runtime_error(bad); });std::cout sum.get() \n; // 5std::cout text.get() \n; // hellotry {boom.get(); // 异常在这里重新抛出} catch (const std::exception e) {std::cout caught: e.what() \n;}pool.shutdown(); // 也可以交给析构return 0;}注意sum.get()与text.get()的先后顺序只影响等待顺序不影响任务执行顺序——多线程下任务的完成次序本来就不确定。要保证顺序只能用单工作线程的池或者在任务之间自行加同步。常见坑点❌ 在析构函数里对工作线程调用detach()然后成员队列、互斥量先被销毁。✅ 析构里先置停止标志、notify_all、再逐个join()确保线程在成员销毁前退出。❌cv_.wait(lk)不带谓词被虚假唤醒后直接tasks_.front()。✅cv_.wait(lk, [this]{ return stop_ || !tasks_.empty(); })醒来后条件一定成立。❌ 持锁执行任务{ lock_guard lk(mtx_); job(); }所有工作者被串行化。✅ 在锁内只取出任务出作用域解锁后再执行。❌ 工作线程中抛出异常且没人捕获程序直接std::terminate。✅ 用packaged_task包装任务或在workerLoop里try/catch兜底记录日志。❌ 任务 lambda 按引用捕获局部变量submit返回后局部变量已销毁。✅ 按值捕获或确保被引用对象的生命周期覆盖任务执行期。❌ 在池内任务里调用pool.shutdown()工作线程join自己。✅ 关闭由池外线程发起池内任务只设置取消标志。❌ 用std::thread::hardware_concurrency()直接当线程数不处理返回 0 的情况。✅ 判零后回退到 1或由调用者显式传入。❌ 丢弃submit返回的 future任务抛出的异常被静默吞掉。✅ 需要感知失败时保留 future 并get()或在任务内部自行处理异常。总结部件作用关键约束工作线程数组长期存活循环取任务析构前必须join任务队列类型擦除后统一存放必须由互斥量保护条件变量队列空时挂起线程必须带谓词防虚假唤醒packaged_task传递返回值与异常不可拷贝用shared_ptr持有停止标志通知线程退出与队列检查在同一把锁下线程池的本质是把「线程」这个昂贵资源变成可复用的池化资源核心难点不在语法而在同步边界锁的粒度、条件变量的谓词、关闭时机的定义。把这三件事写对剩下的就是按业务补充取消、优先级和动态扩缩容。任何涉及共享状态的修改都要在锁内完成任何可能阻塞的调用都不要持锁执行。
