用途:为 Rust 事件驱动系统编程提供最佳实践指南,帮助编写基于异步运行时、通道、套接字、终端与并发的代码。适用于使用 Tokio 或 async-std 构建异步应用、实现网络服务器或客户端、编写终端用户界面(TUI)、管理并发任务与共享状态、处理 Unix 信号与优雅关闭等场景。
主要能力:资料包含 42 条规则,分为 8 类并按影响优先级排序。异步运行时模式(CRITICAL,前缀 async-)包括用 spawn_blocking 处理 CPU 密集任务、biased select 优先处理、避免异步上下文中的 std 阻塞调用、设计可取消安全的异步操作、任务本地存储、用 JoinSet 结构化并发。通道通信(CRITICAL,chan-)包括用有界通道施加背压、oneshot 实现请求-响应、broadcast 扇出、watch 共享状态、通道关闭实现优雅关闭。线程与同步(HIGH,sync-)包括 Arc 共享可变状态、读多写少用 RwLock、原子计数器与标志、避免跨 await 持有 std Mutex、Semaphore 限制并发、高竞争锁用 parking_lot。套接字与网络 I/O(HIGH,net-)包括读写半拆分、framing 编解码、连接池、为所有 I/O 加超时、低延迟协议设 TCP_NODELAY、优雅断开。终端与 TTY(MEDIUM-HIGH,term-)包括退出时恢复终端状态、全屏应用用备用屏幕、异步事件流读取输入、缓冲输出、处理终端缩放事件。信号与进程控制(MEDIUM,sig-)包括 Ctrl-C 优雅关闭、异步处理 Unix 信号、回收子进程避免僵尸、设置关闭超时强制退出。文件 I/O 流式处理(MEDIUM,io-)包括异步文件操作、流式处理大文件、copy_bidirectional 代理、管道进程通信、读前刷新写入。事件循环架构(LOW-MEDIUM,loop-)包括 actor 模式处理有状态组件、类型化事件、类型安全状态机、I/O 与业务逻辑分层、CancellationToken 协调关闭。
使用方式:按需查阅各参考文件中的详细解释与代码示例,包括 references/_sections.md(分类结构与影响等级)、assets/templates/_template.md(新增规则模板)和 metadata.json(版本与参考信息)。规则以固定前缀加主题命名,便于检索。
限制:资料仅列出规则标题与分类结构,未提供每条规则的具体代码示例全文、安装命令、收费信息或效果数据,这些内容暂未提供。