用途:提供编写地道 Rust 代码的惯用法与设计模式,重点利用所有权、借用和类型系统。适用于编写新 Rust 代码、审查 Rust 代码、解决借用检查器问题等场景。
主要能力:以决策树形式组织问题,覆盖借用检查器错误、API 设计、FFI 边界、unsafe 代码和性能关注点。收录的快速模式包括:借用类型(函数参数优先用 &str 而非 &String、&[T] 而非 &Vec<T>);mem::take 模式(从 &mut 中移出拥有值而不 clone);Newtype 模式(零运行时成本的类型安全);Builder 模式(复杂构造);RAII 守卫(通过 Drop 保证清理);Default 与结构体更新语法;栈上动态分发(避免 Box 分配);Option 作为迭代器;闭包捕获控制;临时可变性;出错时返回被消费的参数。另附反模式清单,如为满足借用检查器而 clone、库中使用 #![deny(warnings)]、用 Deref 模拟继承、函数参数使用 &String 或 &Vec<T>、手动调用 drop()、忽略 clippy 对 .clone() 的建议。
使用方式:作为参考文档按需查阅对应模式与决策树;详细示例见 ownership-patterns.md、api-design.md、common-pitfalls.md。
限制:资料未提供安装命令、运行方式、收费或平台信息;具体项目适用性需结合实际情况判断。