Google 发布 Rust 风格指南：不只管格式，还管 API 设计
来源：google.github.io — 2026-10-21
📋 概述
Google 公开了内部使用的 Rust 风格指南，适用范围包括 google3、Android、ChromeOS、Fuchsia 与 Chrome。文档明确「style」不只指排版，还覆盖 API 与实现设计，目标是让跨代码库的 Rust 用法一致并立起质量基线。规则整体偏向可读性与可维护性，宁可写的时候多花点力气；对 async、标准库线程、Rc/Arc、glob 导入等都给了明确的取舍结论。
🔑 核心要点
- 代码组织上要求优先拆小 crate、rust_library 用扁平文件布局、禁用 glob 导入，模块级调用要带模块名
- 所有权章节直接写「避免 Rc 和 Arc」，并要求借用优先于深拷贝
- Chrome 相关代码不要用 async/.await，也不要通过标准库起新线程，Fuchsia 侧则指定 fuchsia_sync::Mutex
- API 设计倾向：参数收 Into、返回迭代器而非集合、用 enum 代替 bool、新类型优于类型别名、能用 derive 就别手写
- 实现细节上 prefer expect over unwrap、匹配 non_exhaustive 枚举不许省分支、拼接格式串用 format!/write!
💡 金句
Style rules should prioritize readability and maintainability over writeability.
👍 0
👎 0
← 返回 Lobsters 首页