SuperAPI AI 工具集

rust

编程与开发

查看项目

更新于 11-11 16:17

技能介绍

Rust 是一个面向 Rust 语言的编码规范类技能,定位为“语言级超级代码指南”,通过对比“错误写法”与“推荐写法”的方式,帮助开发者写出更地道、更高效的 Rust 代码。资料以代码片段加注释的形式组织内容,主要按以下用途分段。

一、所有权与借用 强调不要为了绕开生命周期而滥用 .clone():当数据存活时间足够时,函数应返回引用(如返回 &str 而非 String);参数只在需要拥有数据时才用 String,否则用 &str;在热点路径中避免不必要的 .to_string()/.to_owned(),可借助 Borrow trait 让 HashMap<String, V> 直接接受 &str 作为键。

二、错误处理 生产代码中避免 .unwrap(),应使用 map_err 或 ? 运算符;不要对每次调用都手写 match Result,直接用 ? 传播;避免到处使用 Box<dyn Error> 丢失类型信息,建议库使用 thiserror、应用使用 anyhow,并通过 Context 添加上下文;用 thiserror 的 #[from] 实现错误自动转换,而不是为每个调用点单独定义枚举变体。

三、迭代器 用链式迭代器替代命令式的循环累加与手动求和:filter/map/collect 组合、sum 求和、for item in &items 或 enumerate() 遍历,而不是按下标循环。建议惰性链式调用,只在确实需要具体集合时才调用 .collect()。

四、模式匹配 能用 match 守卫或 filter 简化嵌套 if-let;对多个相同结果的匹配分支改用 matches! 宏;在模式中直接解构字段,而不是在分支体内再逐字段取值。

五、结构体与枚举 不要用携带 bool 的枚举变体表示二元状态,应使用明确的变体(如 Running/Paused/Stopped);避免大量 Option 字段,改用 Default 与构建器模式;对外暴露字段而需要维护不变量的类型,应使用私有字段加构造函数来校验(如 Percentage 的示例)。

六、并发 读多写少的共享数据用 RwLock 替代 Mutex;大量小任务的 CPU 密集并行迭代使用 rayon 的 par_iter;异步场景建议使用 tokio::spawn 与 JoinHandle 实现结构化并发,用 tokio::join! 并发等待。

七、Rust 特有反模式 资料以表格形式列出常见反模式与推荐做法,例如:为取悦借用检查器而 .clone()、非测试代码中的 .unwrap()、返回位置用 impl Trait 隐藏复杂类型、参数用 String 而 &str 足够、嵌套 Option<Option<T>>、没有安全注释的 unsafe 块、Vec<T> 可用时却用 Vec<Box<T>>、以及用 ? 与 RAII 就能处理的场景却手写 Drop。

使用方式与限制 该技能属于语言级编码指南,资料未提供具体安装命令或调用步骤,暂未提供。其明确限制是:只覆盖语言层面的惯用写法,不涉及整体架构决策;过度压缩写法可能降低可读性,需要自行判断取舍。