std::stop_token是c++20引入的协作式线程停止机制，用于安全、优雅地通知线程主动退出；它封装停止请求，支持传递、观察与等待，配合std::jthread实现自动生命周期管理及阻塞点响应。
std::stop_token 是什么，它能解决什么问题
它不是用来“杀掉”线程的，而是让线程自己决定何时安全退出。传统用 std::atomic<bool></bool> 做退出标志，容易漏检查、难同步、无法传递“协作式中断”语义；std::stop_token 把停止请求封装成可传递、可观察、可等待的对象，配合 std::jthread 自动注册和触发，真正实现“优雅”——即线程在完成当前工作单元后主动返回，不打断锁持有、不丢弃资源、不破坏数据一致性。
怎么用 std::jthread + stop_token 写一个可停止的线程
核心是把停止逻辑嵌入循环或阻塞点，而不是靠轮询裸 flag。下面是最小可行写法：
void worker(std::stop_token stoken) {
while (!stoken.stop_requested()) {
// 模拟工作：处理一批任务
do_work();
// 关键：在可能长时间阻塞前检查 token
if (stoken.stop_requested()) break;
// 例如：用带超时的 condition_variable_wait 或 sleep_until
std::this_thread::sleep_for(100ms);
}
cleanup(); // 确保这里执行
}
int main() {
std::jthread t{worker}; // 自动关联 stop_source，无需手动管理
std::this_thread::sleep_for(500ms);
t.request_stop(); // 发起停止请求
// t 自动 join，无需显式调用
}
-
std::jthread构造时自动创建并绑定内部std::stop_source，其stop_token()可直接传给线程函数 - 必须在循环条件里或关键路径上显式调用
stoken.stop_requested()，否则线程根本收不到信号 - 不要在析构函数或 RAII 对象中依赖
stop_requested()—— 此时 token 可能已失效（std::jthread析构时 stop_source 会被销毁）
为什么不能直接用 std::thread 配 stop_token
std::thread 不自带 stop_source，你得手动构造、传递、管理生命周期。稍不注意就会出现悬空 token 或提前销毁：
- 若
std::stop_source在线程函数开始前就析构，stop_token的stop_requested()行为未定义 - 若把
stop_source通过引用传入std::thread，而主线程先于子线程结束，引用悬空 -
std::jthread内部确保stop_source生命周期覆盖整个线程运行期，且request_stop()是线程安全的
所以除非你要精细控制多个线程共享同一个 stop_source（比如批量取消），否则别绕开 std::jthread。
stop_token 在阻塞系统调用里怎么用
它本身不唤醒 sleep_for 或 wait，但标准库提供了配套机制：
- 对
std::condition_variable，用wait的重载版本：cv.wait(lock, stoken, []{ return ready; });—— 若 token 被请求停止，会立即返回false，且stoken.stop_requested()为 true - 对
std::this_thread::sleep_for，没有内置响应，必须拆成短周期轮询：sleep_for(10ms)+ 每次检查stoken.stop_requested() - 自定义阻塞操作（如 socket recv）需结合
std::stop_callback注册回调，在请求发出时设置标志或唤醒 fd，再由业务逻辑主动退出
最易忽略的一点：std::stop_callback 的回调函数必须是无抛异常、无阻塞、快进快出的；它运行在线程的 stop_source 所在线程上下文中，不是目标线程本身。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
