std::latch用于单次同步,等待计数归零后所有等待线程同时放行;它不可重置、无锁、不管理线程生命周期,适用于启动信号等场景,需严格匹配构造计数与arrive()调用次数,并确保对象生命周期覆盖所有线程访问。

std::latch 用在哪?不是用来等所有线程结束的
它只做一件事:等待计数归零,之后所有等待者同时放行。和 std::barrier 不同,std::latch 是一次性、不可重置的;和 std::condition_variable 比,它更轻量、无锁(底层通常基于原子操作),适合“启动信号”这类单次广播场景。
常见错误是拿它当线程 join 替代品——比如在主线程里 latch.wait() 然后就以为子线程都执行完了。其实它不管理线程生命周期,也不保证线程已退出,只保证“它们都抵达了那个点”。
- 典型用法:主线程初始化资源 → 启动 N 个 worker 线程,每个调用
latch.arrive_and_wait()→ 主线程先latch.count_down(N)或逐个arrive()→ 所有 worker 同时开始干活 - 不能用于循环同步(想重复用得换
std::barrier) - 如果构造时传 0,
wait()立即返回,但要注意此时还没任何线程“到达”,只是初始状态已满足条件
构造与计数操作必须匹配,否则会卡死
std::latch 的计数值在构造时固定,后续只能减少,不能读取或重置。一旦构造时设为 N,就必须恰好调用 N 次 arrive() 或等价操作(如 count_down(1)),少一次,wait() 永远阻塞;多一次,触发未定义行为(通常 crash 或 abort)。
容易踩的坑是混用 arrive() 和 count_down(k):前者每次减 1,后者减 k,但内部不校验总和是否超限。比如构造 latch(3),然后调用 count_down(2) 再加一次 arrive(),表面看是 3,但若中间有竞态(比如某线程还没 start 就被调度走),可能漏掉一次 arrive。
立即学习“C++免费学习笔记(深入)”;
- 推荐统一用
arrive():每个 worker 线程自己调一次,语义清晰 - 如果必须批量减少(比如预分配任务组),用
count_down(k),但确保 k ≤ 初始值,且只由协调线程调用一次 - 绝对不要在多个线程里并发调用
count_down()—— 它不是线程安全的
和 std::thread 配合时,注意对象生存期
std::latch 是栈对象?那它必须活到所有线程完成 wait() 或 arrive()。常见错误是主线程函数返回前 latch 已析构,而 worker 还在访问它——UB,大概率 crash。
示例中容易忽略的是:worker 线程捕获 latch 的方式。用引用捕获没问题,但若用值拷贝(不可能,它不可复制),编译就报错;若通过指针传入,要确保指针指向的对象没被提前释放。
- 安全做法:把
std::latch定义在 main thread 的作用域顶部,且晚于所有 thread 对象析构 - 避免把它塞进局部 lambda 里又被 thread::thread 移动走——latch 没移动构造函数,只能引用或指针传递
- 如果 worker 是 detached 状态,必须另配机制(比如
std::shared_ptr+ 自定义删除器)延长 latch 生命周期,否则风险极高
Windows MSVC 和 libstdc++ 的兼容性细节
C++20 标准要求 std::latch 在 <semaphore></semaphore> 头文件里,但实际支持度有差异。MSVC 从 19.30(VS 2022 17.0)起完整支持;GCC 11+ 用 libstdc++ 需开启 -std=c++20 -pthread,且某些旧版存在 arrive_and_wait() 原子性缺陷(表现为偶发跳过等待);Clang 12+ 依赖 libc++,需链接 -lc++。
最稳妥的写法是显式包含头文件并检查宏:
#include <semaphore> #if __cpp_lib_latch >= 201907L // safe to use std::latch #else #error "std::latch not available" #endif
- 别依赖 IDE 的语法高亮来判断是否可用——它可能误报支持
- CI 流水线里务必用目标编译器版本实测,尤其注意 GCC 交叉编译环境常默认禁用 C++20 同步原语
- 生产环境若需向下兼容 C++17,老老实实用
std::condition_variable+std::mutex+ 计数变量,别硬套latch
std::latch 看似简单,但它的“一次性”和“无状态反馈”特性,意味着出错时没有任何提示——卡住就是卡住,崩溃就是崩溃。最容易被忽略的是生命周期管理和计数匹配,这两点不靠静态分析很难发现。










