std::stop_callback 不会自动取消任务，仅在 request_stop() 调用且对象存活时执行一次指定函数；其失效主因是提前析构，因 RAII 特性，定义在 lambda 内则函数返回即注销。
std::stop_callback 不会自动取消任务，也不会中断线程执行；它只在 request_stop() 被调用且对象仍存活时，执行一次你指定的函数。绝大多数“注册了却没触发”的问题，根源不是写法错，而是它提前析构了。
为什么 std::stop_callback 定义在 lambda 里就失效
它是个 RAII 类型：构造即注册、析构即注销。定义在 std::jthread 的启动 lambda 内部时，lambda 函数返回那一刻，cb 就被销毁，后续任何 request_stop() 都找不到回调目标。
常见错误写法：
std::jthread t([](std::stop_token token) {
std::stop_callback cb(token, []{ cleanup(); }); // ❌ 函数退出即析构
while (!token.stop_requested()) { /* work */ }
});
正确做法是让 cb 的生命周期覆盖整个线程运行期：
- 把
std::stop_callback声明在和std::jthread同一作用域（比如紧挨着声明） - 或作为类成员变量，由对象生命周期托管
- 避免捕获局部
std::stop_token到 lambda 内再构造cb，容易绑定到已失效的 token
多个线程共用同一取消信号时，std::stop_source 必须外置
std::jthread 自带私有 std::stop_source，它的 get_stop_token() 只反映本线程是否收到请求，无法被其他线程监听或广播。
想让多个线程响应同一个取消动作（比如 Ctrl+C 或超时），必须显式创建外部 std::stop_source：
- 不能是局部变量——必须比所有使用它的线程活得更久（推荐 static 或全局/成员）
- 每个线程都用
g_stop_source.get_token()获取自己的 token，并各自绑定std::stop_callback - 别复用同一个
std::stop_callback实例到多个线程——每个线程需独立构造
例如处理 SIGINT：
static std::stop_source g_stop_source;
void signal_handler(int sig) {
if (sig == SIGINT || sig == SIGTERM) {
g_stop_source.request_stop(); // ✅ async-signal-safe
}
}
std::stop_callback 适合干啥、不适合干啥
它不是用来做任务主逻辑的，而是为“非工作线程上下文”提供清理入口。关键约束在于：回调不重入、不保证顺序、不阻塞主线程流程。
- 适合：关闭跨线程共享的
std::ofstream、释放std::shared_mutex、记录取消日志、通知外部系统 - 不适合：调用可能阻塞的 I/O（如
close()）、加锁等待其他线程、执行耗时计算、轮询或 sleep - 多个
std::stop_callback绑定到同一 token 时，标准不保证执行顺序，别让它们互相依赖
真正决定任务是否“立即响应”的，从来不是 std::stop_callback，而是任务函数内部是否高频检查 token.stop_requested() —— 回调本身从不干预正在运行的代码流。
比 std::stop_callback 更稳妥的替代方案
多数场景下，直接在任务循环中轮询 token.stop_requested() 比注册回调更简单、更可控，也彻底避开生命周期管理陷阱。
- 无需担心对象析构时机，只要 token 有效，检查就安全
- 可把检查点嵌入到自然阻塞点前（如每次网络读、每处理一块数据后）
- 配合
std::jthread的自动 join 和 request_stop，行为可预测
例如：
std::jthread t([](std::stop_token token) {
while (!token.stop_requested()) {
if (!do_work_step()) break;
std::this_thread::sleep_for(10ms); // 睡眠期间也能响应 stop
}
});
最易被忽略的一点：std::stop_callback 的价值不在“有没有”，而在“活没活到被调用那一刻”。它不解决协作逻辑，只补位清理责任——而这个补位，一旦失约，就没有第二次机会。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
