std::stop_token是C++20引入的协作式线程终止机制，用于替代volatile bool标志；它需配合std::jthread使用，通过stop_requested()轮询或wait()阻塞等待停止请求，由线程主动响应并清理资源。
std::stop_token 是什么，它能解决什么问题
std::stop_token 不是“让线程立刻停”，而是提供一种协作式终止机制：线程主动轮询是否被请求停止，再决定何时、如何退出。它替代了手写 volatile bool flag 或条件变量等待，避免竞态和资源泄漏。
关键点在于「协作」——std::stop_token 本身不触发任何操作，只传递信号；真正响应必须由线程函数自己完成。
如何创建并传递 stop_token 到线程函数
必须通过 std::jthread（C++20 引入），不能用老式 std::thread。因为 std::jthread 自带 std::stop_source，且析构时自动调用 request_stop()，避免忘记清理。
-
std::jthread构造时会把std::stop_token作为首个参数传给线程函数（如果函数签名支持） - 函数形参类型必须是
std::stop_token，不能是const std::stop_token&（否则编译失败） - 若函数有其他参数，
std::stop_token必须放在最前面
示例：
立即学习“C++免费学习笔记（深入）”；
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
void worker(std::stop_token stoken, int id) {
while (!stoken.stop_requested()) {
// 做工作...
std::this_thread::sleep_for(100ms);
}
// 清理资源
}
std::jthread t{worker, 42}; // 自动传入 token，无需手动构造
stop_requested() 和 wait() 的使用差异
stop_requested() 是轻量轮询，适合在循环中高频检查；wait() 是阻塞等待，适用于线程大部分时间空闲、只在特定点响应终止的场景。
-
stoken.stop_requested()：返回bool，无副作用，可多次安全调用 -
stoken.wait()：阻塞直到停止请求发出，但一旦被唤醒，后续调用仍会立即返回（状态不可重置） - 不要在循环里反复调用
wait()—— 它不是条件变量，不会自动重注册监听 - 若需等待 + 响应后继续执行逻辑，优先用
stop_requested()配合std::this_thread::yield()或短延时
错误写法（死锁风险）：
// ❌ 错误：wait() 返回后未检查，且没退出循环
while (true) {
stoken.wait(); // 卡在这里，除非已请求停止
do_cleanup();
}
手动控制停止时机与常见陷阱
多数情况下靠 std::jthread 析构自动触发，但有时需要提前终止（比如用户点击取消）。这时要拿到对应的 std::stop_source。
-
std::jthread提供get_stop_source()方法（C++23 起），C++20 中需在构造时捕获或通过成员保存 - 不要对同一个
std::stop_source多次调用request_stop()—— 无效且可能影响性能 -
std::stop_token是可拷贝的，但所有副本共享同一停止状态；拷贝开销极小，无需担心 - 切忌在线程已退出后再调用
request_stop()—— 行为未定义（尤其在std::jthread已 join 或 detach 后）
容易被忽略的是：std::stop_token 无法感知线程是否真正退出，它只管“请求”。实际退出时机完全取决于你的轮询频率和逻辑位置。
