SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:这是一套 Rust 语言惯例与工程规范,供编写或评审 Rust 代码时遵循,本身不提供运行时功能,只约束代码风格与设计取舍。

主要能力:

  1. 所有权与借用:接受最小所有权类型(&str 优于 &String,&[T] 优于 &Vec<T>),返回拥有值、参数借用;把 .clone() 视为信号而非修复,Rc/Arc 仅用于真正的共享所有权。
  2. 错误处理:可失败返回 Result<T,E>,缺失用 Option<T>,用 ? 传播;库用 thiserror 定义类型化错误,应用用 anyhow::Result 加 .context();unwrap/expect 仅限可证明不变量、const 上下文或测试。
  3. Trait 与泛型:默认静态分发,dyn Trait 仅用于运行时多态;及早派生 Debug 等常用 trait;通过 From/TryFrom/AsRef 等标准 trait 实现转换。
  4. 迭代器与模式匹配:用适配器链替代手写索引循环;match 保持穷尽,用 if let / let else 简化。
  5. 并发选型:CPU 密集用线程或 rayon 的 par_iter,绝不在此用 async;大量 I/O 并发用 async/Tokio;少量阻塞 I/O 用普通线程。共享状态用 Arc<Mutex<T>>/Arc<RwLock<T>>,跨线程移动用 channel。禁止在 async 中阻塞(std::thread::sleep、同步 I/O、长 CPU 循环),改用 tokio::task::spawn_blocking 或 rayon 池。
  6. 项目结构:无 mod.rs 布局(foo 在 foo.rs,子模块在 foo/bar.rs);lint 级别写在 Cargo.toml 的 [lints]/[workspace.lints];用 #[expect(lint, reason="…")] 局部覆盖;unsafe 限于最小模块并写 // SAFETY: 注释。
  7. 工具链门禁:cargo fmt --check、cargo clippy --all-targets --all-features -- -D warnings、cargo nextest run 与 cargo test --doc、cargo deny check(或 cargo audit)。
  8. 文档://! 记 crate/模块,/// 记条目,使用 # Examples、# Panics、# Errors、# Safety 段;doctest 用 ? 而非 unwrap。
  9. 代码导航:对 .rs 使用 rust-analyzer LSP 的 goToDefinition、findReferences、hover、workspaceSymbol、goToImplementation、incomingCalls/outgoingCalls;Grep/Glob 仅用于非语义文本。

使用方式:在 Rust 编码或评审时静默套用这些约定,不逐条叙述规则;先按工作负载选定并发模型;完成前运行上述工具链门禁。

限制与协作:与代码库既有模式冲突时以代码库为准,并仅标注一次分歧;工作流机制交由 the-coder,测试生态交由 rust-testing。资料未说明具体安装步骤、收费方式或平台支持,暂未提供。