用途:这是开发指导技能,不是审查技能,适合在编写新 Rust 函数或模块、在借用/克隆/所有权之间做选择,以及构建 Rust 代码时参考。主题包括所有权、Clippy、性能、泛型分发、类型状态模式、文档、指针类型、API 设计、生态模式等,各主题细节分散在 references 目录文件中。
主要能力:所有权默认借用,仅在需要独立拥有副本时克隆;参数优先 &T、&str、&[T],用迭代器链替代索引循环;用 let Ok(x) = expr else { return } 提前返回,用 ? 传播错误;库用 thiserror、二进制用 anyhow;用 drop guard 管理作用域状态变更,用扩展 trait 为外部类型加方法,用索引指针表示图与树形状。
用法要点:每次提交运行 cargo clippy --all-targets --all-features -- -D warnings;性能声明须用 cargo build --release 构建并给出同工具同指标的前后数值;文档用 cargo doc --no-deps 验证,库 crate 建议启用 #![deny(missing_docs)]。泛型默认静态分发,异构集合或插件架构才用 dyn Trait;edition 2024 中 -> impl Trait 默认捕获所有作用域生命周期,可用 + use<'a, T> 控制。
适用场景:需要编写地道、可维护且安全的 Rust 库或应用,关注编译期不变量、错误处理策略、crate 评估与依赖审计(cargo-deny、cargo-udeps)。
限制:Drop::drop 不能返回错误或 await,需显式 close()/shutdown() 返回 Result;drop guard 在 panic = "abort" 下不执行;Drop 中禁止 block_on;异步 API 需在公共签名上明确 Send 契约,并文档化取消安全性。关于收费、平台、价格等事实,资料暂未提供。