其他风格建议
表达式
尽可能使用 Rust 面向表达式的特性;
// 使用
let x = if y { 1 } else { 0 };
// 不使用
let x;
if y {
x = 1;
} else {
x = 0;
}
命名规范
- 类型应为首字母大写的驼峰命名法(
UpperCamelCase
), - 枚举变量应为首字母大写的驼峰命名法(
UpperCamelCase
), - 结构体字段应使用纯小写下划线命名法(
snake_case
), - 函数和方法名称应使用纯小写下划线命名法(
snake_case
), - 局部变量应为纯小写下划线命名法(
snake_case
), - 宏名称应为纯小写下划线命名法(
snake_case
), - 常量(常量和不可变静态)应使用纯大写下划线命名(
SCREAMING_SNAKE_CASE
) - 当名称是保留字(如
crate
)而禁止使用时,要么使用原始标识符(r#crate
),要么使用尾部下划线(crate_
)——不要拼错单词 (krate
)。
模块
尽可能避免使用 #[path]
标注。