整理人:尚硅谷 - 宋红康

2.1 介绍

软件中随处可见命名。我们给变量、函数、参数、类和包命名。我们给源代码及源代码所在目录命名。
这么多命名要做,不妨做好它。下文列出了取个好名字的几条简单规则。

2.2 名副其实,见名知意

  1. 变量名太随意,hahalist1oktheList 这些都没啥意义

2.3 避免误导

  1. 包含Listimportjava等类名、关键字或特殊字;<br /> 字母o与数字0,字母l与数字1等<br /> 提防使用不同之处较小的名称。比如:XYZControllerForEfficientHandlingOfStringsXYZControllerForEfficientStorageOfStrings

2.4 做有意义的区分

  1. 反面教材,变量名:a1a2a3<br /> 避免冗余,不要出现Variable、表字段中避免出现table、字符串避免出现nameString,直接name就行,知道是字符串类型<br /> 再比如:定义了两个类:Customer类和CustomerObject类,如何区分?<br /> 定义了三个方法:getActiveAccount()、getActiveAccounts()、getActiveAccountInfo(),如何区分?

2.5 使用读得出来的名称

  1. 不要使用自己拼凑出来的单词,比如:xsxm(学生姓名);genymdhms(生成日期,年、月、日、时、分、秒)<br /> **所谓的驼峰命名法,尽量使用完整的单词**

2.6 使用可搜索的名称

  1. 一些常量,最好不直接使用数字,而指定一个变量名,这个变量名可以便于搜索到.<br /> 比如:找MAX_CLASSES_PER_STUDENT很容易,但想找数字7就麻烦了。

2.7 避免使用编码

  1. 2.7.1 匈牙利语标记法<br /> 即变量名表明该变量数据类型的小写字母开始。例如,szCmdLine的前缀sz表示“以零结束的字符串”。<br /> 2.7.2 成员前缀<br /> 避免使用前缀,但是Android中一个比较好的喜欢用m表示私有等,个人感觉比较好<br /> 2.7.3 接口和实现<br /> 作者不喜欢把接口使用**I**来开头,**实现也希望只是在后面添加Imp**

2.8 避免思维映射

  1. 比如传统上惯用单字母名称做循环计数器。所以就不要给一些非计数器的变量命名为:ijk

2.9 类名

  1. **类名与对象名应该是名词与名词短语。**如CustomerWikiPageAccountAddressParser。避免使用DataInfo这样的类名。<br /> 不能使动词。比如:ManageProcess

2.10 方法名

  1. 方法名应当是**动词或者动词短语。**如postPaymentdeletePagesave

2.11 别扮可爱

  1. 有的变量名叫hahabanana<br /> 别用eatMyShorts()表示abort()

2.12 每个概念对应一个词

  1. 项目中同时出现controllersmanagers,为什么不统一使用其中一种?<br /> 对于那些会用到你代码的程序员,一以贯之的命名法简直就是天降福音。

2.13 别用双关语

  1. 有时可能使用add并不合适,比例insertappendadd表示完整的新添加的含义。

2.14 使用解决方案领域名称

  1. 看代码的都是程序员,所以**尽量用那些计算机科学术语、算法名、模式名、数学术语,**<br /> 依据问题所涉领域来命名不算是聪明的做法。

2.15 使用源自所涉问题领域的名称

  1. 如果不能用程序员熟悉的术语来给手头的工作命名,就采用从所涉问题领域而来的名称吧。<br /> 至少,负责维护代码的程序员就能去请教领域专家了。

2.16 添加有意义的语境

  1. 可以把相关的变量放到一个类中,使用这个类来表明语境。

2.17 不要添加没用的语境

  1. 名字中带有项目的缩写,这样完全没有必要。比如有一个名为“加油站豪华版”(Gas Station Deluxe)的项目,<br /> 在其中给每个类添加GSD前缀就不是什么好策略。

2.18 最后的话

  1. 取好名字最难的地方在于需要良好的描述技巧和共有文化背景。