代码整洁之路【1】--有意义的命名

一、名副其实

int d; //消逝的时间,以日计

上面的变量名d仿佛什么也没说,最佳实践应该类似下面这样的变量名表示消逝的时间:

int elapsedTimeInDays;
int daysSinceCreation;
//等其他有意义的变量名

再举个例子:

  public List<int[]> getThem(){
      List<int[]> list1=new ArrayList<int[]>();
      for(int[] x:theList){
         if(x[0]==4) {
            list1.add(x);
       } 
   }
       return lits1;
}

上面的代码是错误的实践,代码具有很高的模糊度。比如:
① theList是什么类型的东西?
② theList零下标条目的意义是什么?
③ 值4的意义是什么?
④ 我怎么使用返回的列表?

改进,以扫雷游戏为例,下面是良好的实践:

public List<Cell> getFlaggedCells(){
  List<Cell> flaggedCells=new ArrayList<Cell>();
  for(Cell cell:gameBoard){
     if(cell.isFalgged()){
           flaggedCells.add(cell);
     }     
   }
    return flaggedCells;
}

这样我们从方法名,到for each语句里的变量,到方法返回list都能看到变量名就猜出大概是做什么事的了。

二、避免误导

必须避免留下掩藏代码本意的错误线索。避免使用与本意相悖的词。
例如:hp、aix、sco都不该用作变量名,因为他们都是UNIX平台或者类UNIX平台的专有名称。

再比如,不要用accuntList来指称一组账号,除非它真的是List类型。List一词对程序员有特殊的意义。如果存储账号的容器并非真是List,就会引起错误的判断。

还有一条,提防使用不同之处较小的名称。
例如:
想要区分XYZControllerForEfficientHandlingOfStrings和另一处的
XYZControllerForEfficientStorageOfStrings,需要花费一些时间,因为它俩太像了,应尽量避免这样。

三、做有意义的区分

首先,以数字序列命名不是良好的实践,例如:a1、a2、a3,这样的命名就完全没有办法知道代码作者的意图。

其实废话是没意义的区分:如果你的项目有以下这三个类:比如Product类,ProductInfo类和ProductData类。虽然它们的名字不同,但是意义却没区别,是意义含糊的废话。

废话都是冗余的,就好比Varaiable这个单词永远不应该出现在变量命中,Table这个单词永远不应该出现在表明中。因为这是废话,难道NameString比Name好么?Name会是浮点数不成?

四、使用读得出来的名称

编程是一种社会活动!不要自己造单词,要使用恰当的英语词!

五、使用可搜索的名称

单字母名称和数字常量有个问题,很难在代码中全局搜索出来。
找MAX_CLASS_PER_STUDENT很容易,但是找数字7就比较

六、避免使用编码

比如可以不用添加m_前缀表示这是一个成员变量。
不用IShapeFactory中的I前缀表示接口等

七、避免思维映射

不应该让读者在脑中把你的名称翻译成他们熟知的名称。这种问题经常出现在选择是使用问题领域术语还是解决方案领域术语时。

八、类名

类名和对象名应该是名词或者名词短语。比如:Customer、Account。
避免使用动词作为类名

九、方法名

方法名应该是动词或者动词短语。比如:sendMessage、deletePage等。

十、别扮可爱

也就是别在代码中抖机灵,用非正式词汇做名称。

比如你好骚啊,抖机灵翻译成“keen how sour”

十一、每个概念对应一词

例如使用fetch、retrieve、get来给在多个类中的同种方法命名。

十二、别用双关语

顾名思义,不要用含义模棱两可的变量名

十三、使用解决方案领域名称

只有程序员才会读你的代码,因此尽管用计算机科学术语、算法名、模式名、数学术语吧。
哪个程序员会不知道JobQueue的意思呢?

十四、使用源自所涉问题领域的名称

如果不能使用程序员熟悉的专业术语给手头的工作命名,那就采用从所涉问题领域而来的名称吧。

十五、不要添加没用的语境

很少有名称是能够自我说明的—多数不能。因此,需要用良好命名的类、函数或名称空间来放置名称,给读者提供语境。
假如有名为firstName、lastName、street、houseNumber、city变量,这的确很明确看出是地址。可是只若看到state呢?此时添加前缀addrFirstName、addrLastName、addrState等,一次提供语境。

参考
《代码整洁之道》

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,718评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,683评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,207评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,755评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,862评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,050评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,136评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,882评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,330评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,651评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,789评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,477评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,135评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,864评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,099评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,598评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,697评论 2 351

推荐阅读更多精彩内容