异步协作别让取消语义藏在实现里异步库交给别人使用前要把约定写到接口附近哪些函数会做网络调用哪些可能阻塞取消后会怎样返回哪些错误。比起一句“高性能”这些信息更能减少误用。如果内部要做同步计算用spawn_blocking或单独的工作线程并限制数量不要悄悄堵住运行时线程。示例和测试用假数据、假服务避免把接入信息写进 README。调用方对返回结果和副作用仍要负责库不能替他们做业务决定。