SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 10-16 01:27

技能介绍

用途:在编写或审查 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 埋点。

使用方式:审查前先阅读相关章节,并在同一轮并行读取所有相关章节;提供反馈时引用相应文件。

限制:本资料为实践指南,未提供具体工具、收费、价格或平台信息。