用途:在编写或审查 Rust 代码时提供一套最佳实践参考,覆盖编码风格、Clippy 检查、性能、错误处理、测试、泛型分派、类型状态模式、注释与文档、指针与线程安全、Tokio 异步模式等十个章节。
主要能力:
- 编码风格与惯用法:优先借用而非克隆,参数用 &str/&[T],小 Copy 类型可按值传递,用 Cow 处理所有权不确定场景。
- 错误处理:可失败操作返回 Result,避免生产环境 panic 与 unwrap/expect;库用 thiserror,二进制用 anyhow;优先用 ? 传播错误。
- 性能:以 --release 基准测试,运行 cargo clippy -- -D clippy::perf,避免循环内克隆,优先迭代器。
- 检查:cargo clippy --all-targets --all-features --locked -- -D warnings,关注 redundant_clone、large_enum_variant、needless_collect 等 lint。
- 测试:描述性命名,每个测试一个断言,公开 API 用文档测试,可用 cargo insta 做快照测试。
- 泛型与分派:性能关键代码用静态分派,异构集合用 dyn Trait,在 API 边界装箱。
- 类型状态模式:用类型系统编码合法状态,在编译期阻止非法操作。
- 异步:不阻塞异步线程,不在 .await 间持锁,用 JoinSet、Semaphore、mpsc/broadcast/oneshot/watch 通道,超时与 CancellationToken 优雅关闭,用 tracing 埋点。
使用方式:审查前先阅读相关章节,并在同一轮并行读取所有相关章节;提供反馈时引用相应文件。
限制:本资料为实践指南,未提供具体工具、收费、价格或平台信息。