代码整洁之道 - 有意义的命名

在小朱元璋出生一个月后,父母为他取了一个名字(元时惯例):朱重八,这个名字也可以叫做朱八八。我们这里再介绍一下,朱重八家族的名字,都很有特点。

朱重八高祖名字:朱百六;

朱重八曾祖名字:朱四九;

朱重八祖父名字:朱初一;

他的父亲我们介绍过了,叫朱五四。

取这样的名字不是因为朱家是搞数学的,而是因为在元朝,老百姓如果不能上学和当官就没有名字,只能以父母年龄相加或者出生的日期命名。(登记户口的人一定会眼花)–《明朝那些事儿》

那么问题来了,朱四九和朱百六是什么关系? 你可能马上懵逼了。所以说:命名不仅仅是一种科学,更是一种艺术

1 名副其实

// bad
var d; // 分手的时间,以天计算

// good
var daysAfterBrokeUp; // 分手以后,以天计算

2 避免误导

// bad
var nameList = 'wdd'; // List一般暗指数据是数组,而不应该赋值给字符串

// good
var nameList = ['wdd','ddw','dwd']; // 

// bad
var ill10o = 10; //千万不要把i,1,l,0,o,O放在一起,傻傻分不清楚

// good
var illOne = 10;

3 做有意义的区分

// bad
var userData, userInfo; // Data和Info, 有什么区别????, 不要再用data和info这样模糊不清的单词了

// good
var userProfile, userAcount

4 使用读得出来的名称

// bad 
var beeceearrthrtee; // 你知道怎么读吗? 鼻涕阿三??

// good
var userName;

5 使用可搜索的名称

// bad
var e = 'not found'; // 想搜e, 就很难搜

// good
var ERROR_NO_FOUND = 'not found';

6 方法名一概是动词短语

// good
function createAgent(){}
funtion deleteAgent(){}
function updateAgent(){}
function queryAgent(){}

7 尽量不要用单字母名称, 除了用于循环

// bad
var i = 1;

// good
for(var i=0; i<10; i++){
    ...
}

// very good
userList.forEach(function(user){
    ...
});

8 每个概念对应一个词

controller和manager, 没什么区别,要用controller都用controller, 要用manager都用manager, 不要混着用

9 建立项目词汇表, 不要随意创造名称

user, agent, org, queue, activity, device...

参考资料

  • 《代码整洁之道》
  • 《明朝那些事儿》
    原文作者:Carl
    原文地址: https://segmentfault.com/a/1190000010925598
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞