std::stop_token仅传递停止信号,需用户代码主动检查并退出;与std::jthread配合时自动绑定停止源,支持协作式取消;不中断阻塞调用,仅condition_variable相关函数原生支持;stop_callback用于清理但非线程安全。

std::stop_token 本身不能直接停止线程,它只是传递“应该停止”的信号;真正响应并退出的必须是用户代码——没有自动中断、不抛异常、也不杀线程。
std::stop_token 怎么和 std::jthread 配合用
std::jthread 是 C++20 中唯一自带协作式取消支持的线程类型,构造时自动关联一个 std::stop_source,其 get_stop_token() 返回的 std::stop_token 可安全传入线程函数:
std::jthread t([](std::stop_token st) {
while (!st.stop_requested()) {
// 做工作...
std::this_thread::sleep_for(100ms);
}
// 清理资源
});- 线程函数参数为
std::stop_token时,std::jthread会自动绑定当前线程的停止源 - 调用
t.request_stop()后,st.stop_requested()将变为true,下次轮询即可退出 - 离开作用域时
std::jthread自动调用request_stop()+join(),避免资源泄漏
手动管理 stop_source 和 stop_token 的场景
当需要多个线程共享同一停止信号,或需在启动线程前就持有控制权时,应显式使用 std::stop_source:
std::stop_source ss;
auto token = ss.get_stop_token();
<p>std::thread t1([&token]{
while (!token.stop_requested()) { /<em> ... </em>/ }
});
std::thread t2([&token]{
while (!token.stop_requested()) { /<em> ... </em>/ }
});</p><p>// 外部统一触发
ss.request_stop(); // t1 和 t2 下次检查都会看到 true
t1.join(); t2.join();-
std::stop_token是可拷贝、可移动、轻量的;std::stop_source不可拷贝,但可移动 - 多个
std::stop_token可来自同一个std::stop_source,实现广播式通知 - 注意:
std::stop_token不保证实时性,它只反映“是否已被请求停止”,不提供等待机制(无wait())
为什么不能用 stop_token 中断阻塞调用(如 sleep_for、mutex lock)
C++20 的 std::stop_token 不修改任何系统调用行为,所有标准库阻塞函数(std::this_thread::sleep_for、std::mutex::lock、std::condition_variable::wait)均不感知 stop_token:
立即学习“C++免费学习笔记(深入)”;
- 不能靠 stop_token 提前唤醒
sleep_for,必须等超时或改用带 token 的重载(如std::condition_variable::wait的stop_token版本) -
std::mutex::lock()永远不会响应 stop_token;若需可取消锁,得用std::shared_mutex或封装成带轮询的循环 - 真正支持 stop_token 的标准函数极少:
std::condition_variable::wait、std::condition_variable::wait_for、std::condition_variable::wait_until(C++20 起)
std::stop_callback 的用途和陷阱
std::stop_callback 用于注册“一旦停止被请求,就执行某段逻辑”,常用于清理或通知,但它不是线程安全的执行入口:
std::stop_source ss;
{
std::stop_callback cb(ss.get_stop_token(), []{
std::cout << "stop requested!\n"; // 可能从任意线程调用
});
ss.request_stop(); // 立即触发回调
}- 回调函数在“停止请求发生时”被调用,但调用线程不确定(可能是 request_stop 所在线程,也可能是其他协作者)
- 回调对象生命周期必须长于
std::stop_callback实例,否则析构时可能触发未定义行为 - 不要在回调里做耗时或阻塞操作;它不是替代线程退出逻辑的手段,而是补充
最易被忽略的一点:stop_token 的协作本质意味着你必须在每个循环/关键路径上主动检查 stop_requested(),漏掉一次就可能卡死;它不替换逻辑设计,只提供统一信号通道。










