必须显式调用 graph.wait_for_all() 启动执行，因 flow graph 惰性调度；graph 对象需长生命周期；function_node 用于带数据转换，continue_node 用于信号触发；multifunction_node 需手动调用 out.try_put() 并检查返回值。
怎么用 tbb::flow::graph 启动一个基础数据流图
必须显式调用 wait_for_all()，否则图可能没执行就退出。tbb 的 flow graph 是惰性执行的：节点连好、输入发出去，但不主动触发调度；得靠 graph.wait_for_all() 阻塞等待所有任务完成。
- 漏掉
wait_for_all()是最常见崩溃/静默失败原因，尤其在 main 函数末尾直接 return -
tbb::flow::graph对象生命周期必须长于所有节点，节点是 graph 的成员（内部管理），不能提前析构 graph - 推荐写法：
tbb::flow::graph g;放在作用域开头，最后调用g.wait_for_all()
function_node 和 continue_node 选哪个
看输入类型：要处理带数据的 token 就用 function_node；只响应“信号”（比如前序任务完成）就用 continue_node。两者语义不同，混用会导致编译失败或逻辑错乱。
-
function_node<int int></int>输入输出都是int，适合 transform 场景 -
continue_node<int></int>输入是continue_msg（无 payload），输出是int，适合做初始化、分发或条件触发 - 注意模板参数顺序：
function_node<input output>，不是反过来；写反了编译器报错信息很长，但关键线索是 “no matching function for call to …”
为什么 multifunction_node 总是只执行一次或漏发数据
因为 multifunction_node 要求你**手动调用 output port 的 try_put()**，它不会自动转发。忘记调用、或只在部分分支里调用，就会丢数据。
- 输出端口是
output_port_type别名，通常需用std::get(out)或命名结构体访问 - 必须检查
try_put()返回值：返回false表示下游缓冲满或已关闭，不能忽略 - 常见错误：把
out当成普通函数调用，写成out(x)—— 这会编译失败，正确是std::get(out).try_put(x)
如何让 flow graph 真正并行起来
默认情况下，tbb 用的是 global task arena，但如果你在非主线程创建 graph，或者嵌套使用，得确认 tbb::task_arena 是否就绪。没有 arena 支持时，某些节点（尤其是带内部 buffer 的）可能退化为串行执行。
- 简单项目：确保链接了 tbb 库（
-ltbb），且运行时能找到libtbb.so或对应动态库 - 多线程环境：避免在
std::thread里直接构造graph，优先用tbb::task_arena统一管理 - 调试技巧：设置环境变量
TBB_PREVIEW_FLOW_GRAPH_TRACE=1，启动时打印节点调度日志，能快速看出是否真并发
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
