std::promise::set_value() 必须在未满足状态下调用，否则抛出 std::future_error（promise_already_satisfied）；对象非线程安全，不可复制，需用 std::move 传递或 std::shared_ptr 共享；void 版本不接受参数；生命周期必须覆盖调用全过程。
std::promise.set_value() 必须在未满足状态下调用
如果 std::promise 已经调用过 set_value()、set_exception() 或关联的 std::future 已被移动/销毁，再次调用 set_value() 会抛出 std::future_error，错误码为 std::future_errc::promise_already_satisfied。这是最常踩的坑——尤其在多线程中未加保护地多次触发。
- 确保每个
std::promise只被成功设置一次；可配合std::atomic<bool></bool>标记是否已设置（但注意：原子标记不能替代 promise 自身线程安全保证） - 不要在析构函数或异常路径中无条件调用
set_value()；建议用 RAII 封装或明确控制生命周期 -
std::promise对象本身不是线程安全的——不同线程不能同时调用它的成员函数；但一个线程调用set_value()，另一个线程等待std::future::get()是安全的
如何把 std::promise 传给另一个线程并安全设置值
直接传递 std::promise 对象会导致移动语义问题（它不可复制），必须用 std::move() 转移所有权，或通过指针/引用 + 同步机制共享。推荐前者，更清晰且避免竞态。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 用
std::thread构造时，把std::promise移动进去：std::thread t([](std::promise<int>&& p) { p.set_value(42); }, std::move(p));</int> - 若需在 lambda 外部保留对 promise 的访问（比如响应事件），改用
std::shared_ptr<:promise>></:promise>，但要确保只调用一次set_value() - 切忌捕获局部
std::promise的引用进线程：栈对象可能在线程启动前就销毁，导致未定义行为
std::promise 的特殊用法和陷阱
当不需要返回值、只用于同步信号时，用 std::promise<void></void> 很常见，但容易忽略其 set_value() 不接受参数，且 std::future<void>::get()</void> 不返回值。
- 调用方式是纯函数式：
p_void.set_value();（括号里不能写任何东西） - 对应
std::future<void></void>的get()仍会阻塞直到完成，但返回类型是void，不能赋值或打印 - 误写成
p_void.set_value(0)会导致编译失败，错误信息类似：no matching function for call to 'set_value(int)'
与 std::packaged_task 和 std::async 的关键区别
std::promise 是底层手动控制机制，而 std::packaged_task 和 std::async 是更高层封装——它们内部也用 std::promise，但自动管理生命周期和调用时机。
-
std::async启动即执行，无法延迟触发；std::promise允许你完全控制“何时”设置结果 -
std::packaged_task可以 move 到任意位置并调用，本质是可调用对象 + 自带 promise；如果你只需要异步执行函数，优先选它而非手管std::promise - 跨线程传递
std::promise时，别混淆std::future的所有权：std::promise::get_future()返回的std::future只能 move 一次，重复 move 或拷贝会引发std::future_error
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
