《代码整洁之道》笔记——第二章:有意义的命名

1、使用读的出来的名称(能读出来,并让第一次这部分代码的人一看便知道这部分代码的作用)。

2、避免含糊不清,如:accountData和accountInfo便会让让人不知这两个变量的区别是啥。

3、名称长短应与作用于大小相对应。

4、尽量避免成员前缀,如:m_前缀。把类和函数做得足够小,来消除对成员前缀的需要。(但并不代表所有情形都不用,在一些情况下,加前缀仍然是有效避免变量被误覆盖的有效方法)

5、类名和对象名应当是名词或名词短语,如:Customer,WikiPage,避免使用含义模糊的名词如:Manager,Data。并且类名不应当是动词。

6、与类名相反,方法名应当是动词或动词短语,如postPayment,deletePage。属性访问器、修改器和断言应该根据其值命名,并依Javabean标准[10]加上get、set和is前缀。

7、每个概念对应一个词,如:DeviceManager和ProtocolController,为什么要分Manager和Controller,这可能会误导新人觉得你的ProtocolController的作用和Manager不同,如果这两个类负责的都是管理,那ProtocolController可以改成ProtocolManager,反过来说,如果不是同一个概念,如果ProtocolController不是负责管理的功能,那么它就最好别改成ProtocolManager,避免误导他人。

posted @ 2020-02-23 19:44  夜里寻星  阅读(159)  评论(0)    收藏  举报