P.NAM.01 同一个crate中标识符的命名规则应该使用统一的词序

【描述】

具体选择什么样的词序并不重要,但务必要保证同一个 crate 内词序的一致性。 若提供与标准库中相似功能的东西时,也要与标准库名称的词性顺序一致.

拿错误类型来举个例子:

当crate中类型名称都按照 动词-宾语-error 这样的顺序来命名错误类型时,如果要增加新的错误类型,则也需要按同样的词序来增加。

以下是来自标准库的处理错误的一些类型示例:

如果你想新增和标准库相似的错误类型,比如“解析地址错误”类型,为了保持词性一致,应该使用ParseAddrError 名称,而不是AddrParseError

说明:现在标准库文档中 net模块解析地址错误类型是 AddrParseError,其实和标准库中大部分错误类型遵循的 "动-宾-Error" 词序没有保持一致,所以它是一个特例。

【反例】


#![allow(unused)]
fn main() {
// 不符合:与标准库错误类型词序 "动-宾-Error"  不一致,应该为 ParseAddrError
struct AddrParseError {}
}

【正例】


#![allow(unused)]
fn main() {
// 符合: 与标准库错误类型一致
struct ParseAddrError{}
}