命名

  名副其实:如果名称需要注释来补充,那就不算是名副其实;

       对常量操作,常量的意义是什么?数组下标条目的意义是什么?对于返回值,该如何使用?

  避免误导:避免使用与本意相悖的词;

  做有意义的区分:添加数字系列或废话是无意义的区分;

  使用读得出来的名称;

  使用可搜索的名称:单字母名称和数字常量很难在一大篇文字中找出来;

  避免使用编码:匈牙利语标记法(设置类型)、成员前缀、接口和实现

  避免思维映射:不应当让读者在脑中把你的名称翻译为他们熟知的名称;

  类名:类名和对象名应该是名词或名词短语,避免使用Manager、Processor、Data、Info这样的类名;

  方法名:方法名应该是动词或动词短语,属性访问器、修改器和断言加上get、set、is前缀;

      重载构造器时,使用描述了参数的静态工厂方法名;可以将构造器设置为private,强制使用这种命名手段;

  别耍宝:名称别耍宝,言到意到,意到言到;

  每个概念对应一个词:给每个抽象概念选一个词,并且一以贯之;

  别用双关语:避免将同一单词用于不同目的;

  使用解决方案领域名称,使用源自所涉问题领域的名称;

  添加有意义的语境:很少有名称能自我说明的,所以需要:用有良好命名的类、函数或名称空间来放置名称,给读者提供语境;或者给名称添加前缀;

           只要短名称足够清楚,就比长名称好,别给名称添加不必要的语境;

posted @ 2018-08-23 16:44  xiao_jian  阅读(136)  评论(0)    收藏  举报