std::stop_callback未执行的最常见原因是对象提前析构，而非逻辑错误；它必须存活至request_stop()调用且回调执行完毕，推荐作为类成员或在线程变量后声明为局部变量。
std::stop_callback 本身不取消任务，也不中断线程；它只在 request_stop() 被调用时、且对象仍存活的前提下，执行一次你指定的函数。绝大多数“没触发”问题，根源是对象提前析构，而非逻辑写错。
std::stop_callback 为什么注册了却完全不执行
最常踩的坑不是回调函数写得不对，而是 std::stop_callback 实例在 request_stop() 发生前就销毁了——RAII 特性让它“生即注册、死即注销”，一旦离开作用域，就彻底失联。
- 错误模式：
std::jthread t([](std::stop_token token) { std::stop_callback cb(token, []{ cleanup(); }); /* cb 是栈上局部变量，lambda 返回即析构 */ });→ 后续t.request_stop()无回调可执行 - 根本原因：lambda 参数作用域太短，
cb生命周期远早于可能的取消请求时间点 - 验证方法：在回调里加日志并确保能输出；若日志从不出现，优先怀疑生命周期，而非
request_stop()是否被调用 - 注意捕获：若回调中访问外部对象（如
std::ofstream），必须值捕获或用std::shared_ptr，不能捕获栈变量引用，否则析构后访问即 UB
std::stop_callback 应该声明在哪才安全
它的生存期必须覆盖“request_stop() 被调用”到“回调函数执行完毕”的整个窗口。实践中只有两类位置真正可靠：
- 作为类成员变量持有，绑定到长期生命周期对象（如
class TaskManager { std::stop_callback cb_; };） - 在线程启动前、同一作用域内声明为局部变量，且顺序在
std::jthread变量之后：std::jthread t(fn); std::stop_callback cb(t.get_stop_token(), []{ ... }); - 若需跨多个线程响应同一信号，必须用外部
static std::stop_source g_stop_source;，再分发其get_token()，不能依赖std::jthread自带的私有 token - 绝对避免：在循环体内、函数参数、lambda 内部、或任何可能提前返回的作用域中定义
std::stop_callback
std::stop_callback 里能做什么、不能做什么
它运行在调用 request_stop() 的线程上下文中（不一定是工作线程），因此必须轻量、无锁、不阻塞、不重入。
- ✅ 安全操作：
done_flag.store(true, std::memory_order_relaxed)、cv.notify_one()、关闭裸文件描述符（close(fd)）、释放非托管内存（delete ptr） - ❌ 危险操作：
std::ofstream::close()、std::mutex::lock()、write()、fsync()、std::this_thread::sleep_for()—— 这些会拖慢整个取消路径，甚至导致request_stop()长时间无法返回 - ⚠️ 多个
std::stop_callback绑定到同一std::stop_token时，标准不保证执行顺序，禁止让它们互相依赖或竞争同一资源 - ⚠️ 回调不抛异常、不改变线程状态、不中断当前执行流 —— 它只是“通知”，不是“指令”
比 std::stop_callback 更简单可靠的替代方案
多数实际场景下，直接轮询 token.stop_requested() 比管理 std::stop_callback 生命周期更清晰、更少出错。
- 在任务主循环头部插入：
if (token.stop_requested()) return; - 在阻塞调用（如
read()、sleep_for()）前检查，避免无限等待 - 对长周期计算做分片，例如每处理 100 个数据单元后检查一次
token.stop_requested() -
std::jthread对std::this_thread::sleep_for()有原生支持，睡眠期间可响应取消；但你自己写的忙等（while(!done);）不会自动响应
真正难的不是写回调函数，而是确保它活得到被调用的那一瞬间，同时不干扰主线程节奏——尤其当它要访问共享状态时，同步遗漏或竞态极易发生。轮询方式天然规避了生命周期判断负担，也更贴近协作式取消的本质：任务自己决定何时停、停在哪、怎么收尾。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
