HeadlinesBriefing HeadlinesBriefing.com

谷歌Rust风格指南:保持代码一致性的规则

Hacker News •
×

谷歌发布了其Rust风格指南,该文件规范了谷歌各代码库中Rust的编写方式,these代码库包括google3、Android、Chrome OS、Fuchsia和Chrome。该指南的内容不仅限于格式,还延伸至API与实现设计。其明确目标是在这些代码库内部及之间保持Rust使用的一致性,同时确立质量标准。

该指南的权威范围因项目而异。Android、Chromium及其他代码库在指南编写过程中均参与了咨询,并打算开始应用该指南,不过各自可以决定对指南执行的严格程度。关于采用情况的信息预计将随着这些代码库的采用而陆续公布。

该指南的目标在很大程度上与谷歌的C++风格指南相呼应。其大多数规则都可追溯到这些目标中的一个或多个,其中可读性与可维护性优先于编写便利性。作者指出,代码预计将长期使用,因此在编写代码时多付出少量努力被认为是值得的。

该文件分为多个章节,涵盖代码组织、格式、所有权与借用、函数输入与输出、类型、trait、泛型、并发、命名、文档、unsafe代码以及实现相关问题。指导内容包括优先使用小型crate、避免通配符导入、避免使用Rc和Arc,以及在API中优先使用枚举而非布尔值。

来源: Hacker News · 由HeadlinesBriefing整理摘要