SuperAPI AI 工具集

rust-best-practices

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:在编写、修改或评审 Rust 代码时使用,建议在编辑 Rust 代码前调用,提供基于 Microsoft Pragmatic Rust Guidelines 与 Rust 社区标准的实践指导。

核心原则:利用类型系统让非法状态不可表示;顺应借用检查器而非对抗它;显式表达可失败性、可变性与生命周期;使用迭代器、泛型与 trait 实现零成本抽象;尽早校验、显式处理错误。

主要能力: 错误处理:库使用 thiserror 定义错误枚举,应用使用 anyhow 并配合 Context 添加上下文;库中避免 panic,越界访问返回 Option 或 Result。 API 设计:复杂配置使用 Builder 模式;用 Newtype 包装原始类型避免 primitive obsession,并在构造函数中校验;参数接受 impl Trait(如 impl IntoIterator)以提升灵活性。

使用方式:作为技能在 Rust 编码、修改或评审时调用,具体安装与调用命令资料未提供。

适用场景:Rust 库与应用开发、代码评审、API 设计、错误处理策略选择。

限制:资料未提供收费、价格、平台支持范围与效果数据;references/advanced.md 涉及性能、异步、测试与反模式示例,但具体内容未在资料中展开。