把信息装到名字中

这个话题很重要,因为会影响到你代码库中的每一行代码。尽管每个改变可能看上去都很小,聚集在一起造成代码库巨大的改进。如果你的代码有很棒的名字、写的很好的注释,并且整洁地使用了空白符,你的代码会变得易读得多。

无论是命名变量、函数还是类,都可以使用很多相同的原则。我们喜欢把名字当做一条小小的注释。尽管空间不算很大,但选择一个号名字可以让他承载很多信息

本章的思想:把信息装入名字中。

本章的6个专题:

  1. 选择专业的词。
  2. 避免泛泛的名字(或者说要知道什么时候使用它)。
  3. 用具体的名字代替抽象的名字。
  4. 使用前缀或者后缀给名字附带更多信息。
  5. 决定名字的长度。
  6. 利用名字的格式来表达含义。
选择专业的词

要避免使用“空洞”的词。
比如在二叉树中的一个例子:
class BinatyTree
{
int Size();
};
这个 Size() 什么意思呢?这是个疑问,因为它没有承载很多信息。更专业的词可以是 Height()、NumNodes() 或者 MemoryBytes()。
再比如stop这个词,这个词的意思是停止,但是准确来说是暂停?还是终止?其实更贴切的词是kill、pause、shutdown等。

找到更有表现力的词
  • 单词send对应的词有:deliver、dispatch、announce、distribute、route ……
  • 单词find对应的词有:search、extract、locate、recover ……
  • 单词start对应的词有:launch、create、begin、open ……
  • 单词make对应的词有:create、set up、build、generate、compose、add、new ……
循环迭代器

像i、j、iter和it等名字常用作索引和迭代器。
但有时会有比这些更贴切的迭代器命名。例如:

for (int i = 0; i < clubs.size(); i++) {
    for (int j = 0; j < clubs.members.size(); j++) {
        for (int k = 0; k < users.size(); k++) {
            if (clubs[i].members[k] == users[j])
                cout << "user[" << j << "] is in club[" << i << "]" << endl;
        }
    }
}

在if条件语句中,members[]和user[]用了错误的索引。这样的缺陷很难被发现,因为一行代码单独来看似乎没有问题:

if (clubs[i].members[k] == users[j])

在这种情况下,使用更精确的名字可能会有帮助。
如果把i、j、k对应改为:club_i、member_i、user_i,或者简单点:ci、mi、ui。这样就变成了这样

if (clubs[ci].members[ui] == users[mi]) // 这样错误就一目了然了
为名字附带更多信息

一个箱子里装了一只危险的动物,封上口,箱子上写着“动物”两个字,很多人可能会好奇打开看看是什么动物,如果打开则他自己就会受伤。如果这个箱子上再加上“危险”这两个字,就不会有这样悲剧发生了。
为名字附带更多信息在单位的值中使用是最明显的,例如JavaScript中度量一个网页的加载时间

var start = (new Date()).getTime();

如果这个start变量更改为start_ms是不是更明显呢?

总结

  1. 使用专业的单词,例如,不用Get,而使用Fetch或者Download可能会更好,这由上下文决定
  2. 避免空泛的名字
  3. 使用具体的名字来更细致地描述事物,ServerCanStart()这个名字就比CanListenOnPort更不清楚。
  4. 给变量名带上重要的细节,例如值为毫秒的变量后面加上ms,或者在还需要转义的,未处理的变量前面加上raw
  5. 为作用域大的名字采用更长的名字,不要用让人费解的一个或两个字母的名字来命名在几屏之间都看见的变量。对于只存在于几行之间的变量用短一点的名字更好。
  6. 有目的地使用大小写、下划线
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,588评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,456评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,146评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,387评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,481评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,510评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,522评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,296评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,745评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,039评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,202评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,901评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,538评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,165评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,415评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,081评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,085评论 2 352

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,973评论 25 707
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,608评论 18 399
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,646评论 18 139
  • 小伙伴们,swift开源啦! <Writing High-Performance Swift Code>中的信息会...
    Fosen波波阅读 771评论 3 5
  • 行行重行行,与君生别离。 相去万余里,各在天一涯。 道路阻且长,会面安可知! 胡马依北风,越鸟巢南枝。 相去日已远...
    流下了穷人泪阅读 251评论 0 0