用途:在编写、审查或重构 Rust 代码时提供系统化规范,目标为 Rust 1.80+ 与 Edition 2024,覆盖从所有权到性能调优的常见决策点。
主要能力:按优先级组织为 14 类规则,包括所有权与借用(own-)、错误处理(err-)、内存优化(mem-)、API 设计(api-)、异步(async-)、编译器优化(opt-)、命名(name-)、类型安全(type-)、测试(test-)、文档(doc-)、性能模式(perf-)、项目结构(proj-)、Clippy 与 lint(lint-)以及反模式(anti-)。规则文件位于 rules/ 目录,每个前缀组一个文件,每条规则以 ## <rule-id> 分节,便于按规则 ID 检索。
典型规则示例:优先借用而非 clone;参数用 &[T]、&str 而非 &Vec<T>、&String;库用 thiserror、应用用 anyhow;生产代码避免 unwrap;异步中不跨 await 持有锁;用 tokio::join!、try_join!、select! 组织并发;用 with_capacity、SmallVec、Box<[T]> 等控制内存;用 newtype、typestate、#[non_exhaustive] 设计 API;用 #[cfg(test)]、proptest、mockall、criterion 测试与基准。
Edition 2024 变化:extern 块需包在 unsafe 中;unsafe fn 内需显式 unsafe 块;if let 临时值作用域调整;gen 关键字保留;新增 #[diagnostic::on_unimplemented];嵌套 or 模式稳定。可用 cargo fix --edition 自动应用大部分改动。
适用场景:新写函数、结构体或模块;实现错误处理或异步代码;设计库的公开 API;审查所有权与借用问题;优化内存与热路径性能;重构既有 Rust 代码;排查编译器错误。
限制:资料未提供具体安装命令、收费方式、平台支持范围或效果数据;规则为通用指导,实际项目需结合自身约束判断。