用途:在编写或审查符合习惯用法的 Rust 代码时使用,针对稳定版 1.98.1、edition 2024,聚焦编译器不会替你发现的问题——避免无谓克隆的所有权设计,以及机器生成 Rust 的反复出现的失败模式。
主要能力:edition 2024 特性(let chains、async 闭包等);所有权与借用(函数签名与数据流设计);LLM 常见陷阱(clone 税、unwrap/expect 泛滥、String 与 &str 误用、索引循环替代迭代器、可省略的生命周期标注)。
关键规则:参数优先借用(&T/&str/&[T]),除非函数必须持有值;.clone() 需有理由,仅为消除借用检查错误而克隆是设计异味;可失败值不得无理由 .unwrap()/.expect(),优先 ?、match 或写明不变量;引用计数句柄用 Arc::clone(&x);优先迭代器而非索引循环;让编译器省略生命周期。
使用方式:先确认当前稳定版本与特性稳定版本,再读取 Cargo.toml 中的 edition 与既有所有权约定;写完后运行 fuse-ai-pilot:sniper 与 cargo clippy。不要凭记忆陈述稳定版本,需对照官方发布页核实。
已核实事实:edition 2024 于 Rust 1.85.0 稳定;let chains 于 1.88.0 稳定且仅限 edition 2024;async 闭包于 1.85.0 稳定;gen blocks 仍不稳定,勿在稳定版使用。
限制:错误类型设计(thiserror 与 anyhow)属于 rust-error-handling;异步运行时问题属于 rust-async-concurrency;SOLID 与文件布局规则属于 fuse-solid:solid-rust。