用途:用于 Rust 代码审查,强调一致性、安全性与可维护性,审查标准参考 https://github.com/apollographql/rust-best-practices。
主要能力:提供合并前必查项,包括所有权与数据流是否有意为之、错误处理是否显式且符合 crate/二进制边界、改动文件的 Clippy 与格式是否干净、性能变更是否先测量、公共 API 是否有文档且与运行时行为一致、测试是否覆盖预期行为与错误路径、unsafe 或裸指针使用是否有正当理由并受限。
严重级别矩阵:P0 为 unsafe 内存错误、可恢复生产路径中的 panic、静默数据损坏;P1 为正确性缺陷、缺少错误传播、无效 API 契约;P2 为可能的性能回退、缺少公共 API 文档、不稳定测试;P3 为风格与可读性问题、可避免的 clone/分配、不必要的复杂度。
审查要点:优先借用而非克隆,仅在需要所有权或明确快照时使用 Clone,拒绝在 Copy 类型上 clone;Copy/小型 POD 按值传递,大型堆对象按引用传递,用 Cow 处理可能借用或拥有的输入;用 let-else、if let-else 与 ? 处理可失败控制流,生产代码避免 unwrap/expect;优先 _else API 避免急切分配,保持迭代器惰性;数据转换用迭代器链,提前退出或副作用重的循环用 for;运行 cargo clippy --all-targets --all-feature --locked -- -D warnings 并修复警告,避免全局静默有用 lint,优先用带理由的 #[expect(clippy::...)];库用 thiserror 类型化错误,二进制可用 anyhow 但保留丰富上下文;测试一个行为一个断言、命名描述化,内部用单元测试、公共行为用集成测试,快照测试仅用于复杂稳定输出;文档用 /// 与 //! 说明 API 行为与约束,// 说明原因、安全理由与假设,TODO 关联 issue。
快速拒绝触发:热路径中不必要的 clone、无正当理由的 allow(clippy::...)、丢弃根因的静默 Err 恢复、无意图证明的大类型按值复制、仅复述代码的注释、无归属与上下文的 TODO。
限制:资料未提供安装命令、平台支持、收费方式或具体使用步骤,暂未提供。