1. 概述

状态

• 《Rust 编码规范》目前为 V 1.0 beta 试行版，改进内容参考 Changelog

详细

• 1.1 为什么需要 Rust 编码规范
• 1.2 编码规范基本约定

介绍

Rust 语言社区内其实分散着很多编码规范，下面罗列一部分公开信息：

• 官方｜Rust API 编写指南
• 官方 | Rust Style Guide
• Rust's Unsafe Code Guidelines Reference
• 法国国家信息安全局 | Rust 安全（Security）规范
• Apache Teaclave 安全计算平台 | Rust 开发规范
• PingCAP | 编码风格指南（包括 Rust 和 Go 等）
• Google Fuchsia 操作系统 Rust 开发指南
• RustAnalyzer 编码风格指南
• 使用 Rust 设计优雅的 API
• Rust FFI 指南

上面这些除了 Rust 官方和法国国家信息安全局的编码规范之外，其他开源项目的编码规范主要是为了规范贡献者们遵循一个统一的编码风格。

所以，一个通用的，覆盖编码风格和具体编码实践的全面的编码规范，更有助于社区各个开源项目和各大公司参考去制定自己的编码规范。

本规范致力于成为统一的 Rust 编码规范，各大公司可以依赖本规范，结合自己的业务领域和团队习惯，形成自己的编码规范，并可以在日常实践中反哺本规范，让本规范更加完善。