第二章 有意义的命名

Posted 2021-01-15 quepq

1、名副其实；

2、避免误导，堤防使用不同之处较小的名称；

3、做有意义的区分，a1，a2这种命名不要出现；

4、使用读得出来的名称；即你读这个名称，就明白这个变量，函数，或者是类大概是干什么的。

5、使用可搜索的名称，代码里面有需要用到数字的时候，用常量替代；

6、避免使用编码，比如带一些前缀，下划线这种；

7、避免思维映射，不应当让读者在脑中把你的名称翻译为他们熟知的名称。比如循环计数器，i、j、k 。

8、类名，类名和对象名应该是名词，或者名词短语；

9、方法名，应该是动词，或者动词短语；

10、别扮可爱，其实就是名称要尽量明确；

11、每个概念对应一个词，即给每个抽象概念选一个词，并且一以贯之。那些经常会读到你代码的人，简直天降福音；

12、别用双关语，避免将同一个单词用于不同的目的；

13、使用解决方案领域的名称，只有程序员才会读你的代码，所以尽管用那些计算机科学术语，算法名，模式名，数学术语。

14、使用源自所涉问题领域的名称；如果不能用程序员熟悉的术语来给手头的工作铭铭，就采用从所涉问题领域而来的名称；

15、添加有意义的语境，很少有名称是能自我说明的，需要用有良好明明的类，函数或名称空间来放置。如果没有这么做，那就只能加前缀了；

16、继承上一条，不要添加没用的语境。