用途:这是一套结构化的 Rust 惯用写法最佳实践指南,用于编写新代码、评审 Pull Request、重构以及设计公共 API。
主要能力:按优先级分为八类,共 41 条规则。所有权与借用(own-,CRITICAL)6 条;错误传播(errprop-,CRITICAL)6 条;类型安全(safe-,HIGH)6 条;集合与迭代器(iter-,HIGH)5 条;异步模式(asyncp-,MEDIUM-HIGH)5 条;API 设计(api-,MEDIUM)5 条;序列化(serial-,MEDIUM)4 条;性能(perf-,LOW-MEDIUM)4 条。每条规则含错误与正确示例,并使用真实领域命名与量化影响指标。
使用方式:写代码前先看 CRITICAL 类规则;实现中遵循类型安全与集合规则;设计 API 时应用 API 设计与序列化规则;优化时使用性能规则。规则分布在 references 目录下的对应文件中,如 references/_sections.md、references/own-.md、references/errprop-.md、references/safe-.md、references/iter-.md、references/asyncp-.md、references/api-.md、references/serial-.md、references/perf-.md。
适用场景:任何项目或 crate 的 Rust 代码编写、PR 评审、减少多余克隆或手工循环的重构、库或共享模块的公共 API 设计、异步代码的正确性与取消安全优化。
限制:资料未提供具体安装命令、版本要求、许可证、收费方式与平台信息,暂未提供。