应《网络安全法》要求，自2017年10月1日起，未进行实名认证将不得使用互联网跟帖服务。为保障您的帐号能够正常使用，请尽快对帐号进行手机号验证，感谢您的理解与支持！

24小时热门版块排行榜    

小木虫论坛-学术科研互动平台 » 计算模拟区 » 程序语言 » 其它 » 【转帖】世上最糟糕的两个变量名
51/1返回列表
查看: 788  |  回复: 4
只看楼主 @他人 存档 新回复提醒 (忽略) 收藏    在APP中查看

yalefield

金虫 (文坛精英)

老汉一枚

[交流] 【转帖】世上最糟糕的两个变量名 已有4人参与

Andy Lester

最近我对Steve McConnell的著作Code Complete（第二版）做了技术校对，这本书将在六月份出版。 他真是用心良苦，竟然用掉了整整一章的篇幅来讨论如何给变量命名。 但有个问题，他只是点到为止，并没有深入的探讨，这个问题就是：有两个世上最糟糕的变量名称。 请允许我就此问题发表拙见。

糟糕的变量名几乎到处都是。 常见的一种情况是人们喜欢把变量名的到很短、但变量的生存范围又太大，比如，有人会在整个程序里使用像 $n 这样的变量。 有些程序员可能会知道，在 TRS-80 BASIC语 言里， 只是变量名的前两位字符是有意义的，以至于我们编程是必须把一个手抄本的变量名表格放在键盘旁边参考。

有些时候你会发现某些人命名变量的简化策略是把单词中的元音去掉，用此来替换简单的截取的方式，于是本来是 $cust 的变量名变成了 $cstmr。我很怀疑人们能否分清这个变量是代表 customers 呢，还是表示 costumers!

有时候你会发现有些变量名是故意起的很怪，作者觉得这样做非常有趣，而不是非常有用。我曾经看到一个循环语句里被命名为 $crap(屎) 的变量。我的一位同事在维护旧代码时，把一个函数命名为 THE_LONE_RANGER_RIDES_AGAIN() (“徘徊者”号航天器又能起飞了)。 这类变量名都不是我在这里要说的糟糕的变量名。

关于变量命名规范之争通常会演化为一场关于宗教信仰的战争，但是，我确有十足的信心来宣布这 世上最糟糕的变量名是：
CODE:
$data

当然，它确实表明这是个数据！它表明变量里能放什么东西！它表明变量里什么都能放！就像是你收拾打包你的物品，把它们移到一个新房子里，你在包箱外面写着，用很粗的黑字写着：“东西”。

即使这个变量是个函数指针，它里面的数据也是告诉程序何处去运行这个函数。 即使这个变量是 undef 或 NULL, 包含这种值的变量本身就具有特殊意义。

变量名应该表明变量里装载了什么数据。 问问自己“是什么数据”，这是优化你的变量命名最简单的方法。我曾经看到有人用 $data 表示从数据表里读取的一条记录。写法就像这样：
CODE:
    $data = read_record();
    print "ID = ", $data["CUSTOMER_ID"];

问问自己”是什么数据“将会立即给你一个好的命名思路。 命名成 $record 就好多了。 $customer_record 那就更好了。

我开篇就说过有两个最糟糕的变量名，我相信没有人会反对我提出这 世上第二糟糕的变量名 是：
CODE:
$data2

非常普遍，当任何一个变量依赖于序列号来区别跟它相似的数据时，你需要立即重新考虑这个变量命名。 常常你会看到像这样的代码：
CODE:
    $total = $price * $qty;
    $total2 = $total - $discount;
    $total2 += $total * $taxrate;

    $total3 = $purchase_order_value + $available_credit;
    if ( $total2 < $total3 ) {
        print "You can't afford this order.";
    }

让我们用考古学的方式挖掘这段代码。
首先，这段代码只是指明了订单的总额， $total。如果没有其它的，这个 $total 定义的无可挑剔。 可不幸的是，有人在此之后加了一段代码，用来处理折扣和税率，偷懒的将它们存到 $total2里。 最后，有人又加了一段，用来检查用户支付的总值，并把变量命名为 $total3。

这段代码里最关键的能反映问题的一句是：
CODE:
    if ( $total2 < $total3 )

如果你不回头看看这两个total都是存的什么，你不可能知道这句是在计算什么。

如果你正在面临着要给某变量命名成 $total2 的问题， 请先把已有的变量名变的更有意义。 花上几分钟的时间，给这些变量合适的名称。这个层面上的代码反省是你能做到的最简单的，成本最低的，形式最安全的反省， 特别是当这个变量在一个封闭的子程序里时，更需要这样。

让我们对上面这段糟糕的代码做一个简单的查找替换过程：
CODE:
    $order_total = $price * $qty;
    $payable_total = $order_total - $discount;
    $payable_total += $payable_total * $taxrate;

    $available_funds = $purchase_order_value + $availble_credit;
    if ( $payable_total < $available_funds ) {
        print "You can't afford this order.";
    }

变化的只有变量名，这样一来这段代码就很容易理解了。 现在所有的 _total 变量都不存在歧义了。 而且，你会发现： if 比较语句写颠倒了。 有效的命名让这种错误极易发现。

这种以数字结尾的变量并不是都不好，有个例外。如果这个实体本身就是以数字结尾的，变量也应该留下这个数字。对于跨省的国道的变量命 名就应该像 $route31。如果你把它改成 $route_thirty_one 那就有点傻了。
最后，记着这些命名习惯对于定义程序变量和定义文件名同样适用。 我通常也不愿意花太多的时间去考虑文件的命名，当然这是另外一个话题了。

还有什么其他的让你抓狂的命名现象？
http://www.oreillynet.com/onlamp/blog/2004/03/the_worlds_two_worst_variable.html

[ Last edited by yalefield on 2010-5-12 at 00:19 ]
回复此楼

» 猜你喜欢

» 本主题相关价值贴推荐，对您同样有帮助:
1楼 2010-05-12 00:17:57
已阅   回复此楼   关注TA 给TA发消息 送TA红花 TA的回帖

magic7004

金虫 (职业作家)
★ ★
小木虫(金币+0.5):给个红包，谢谢回帖交流
余泽成(金币+1):谢谢参与讨论！ 2010-05-12 09:32:24
楼主说的这个根本不算最糟糕的

void calc()
{
int a = 1, b = 2, c=3;
int sum, average;
average = a+b+c;
sum = average /3;
cout<<"sum = " << average << endl;
cout<<"average = " << sum << endl;
}

这段代码里的sum和average才是世界上最糟糕的变量名。
赞一下(2人) 回复此楼
流氓不可怕，可怕的是流氓有文化，有文化又BH的流氓无敌~~！
2楼2010-05-12 08:50:33
已阅   回复此楼   关注TA 给TA发消息 送TA红花 TA的回帖

sxlion811

金虫 (正式写手)
★
小木虫(金币+0.5):给个红包，谢谢回帖交流
命名确实是个比较值得考虑的问题。

很多语言的变量命名都很讲究的。
赞一下(1人) 回复此楼
开心努力一辈子
3楼2010-05-13 08:29:37
已阅   回复此楼   关注TA 给TA发消息 送TA红花 TA的回帖

wangen994

荣誉版主 (著名写手)

将军
★
小木虫(金币+0.5):给个红包，谢谢回帖交流
一开始的时候就应该养成一个好的习惯
赞一下(1人) 回复此楼
4楼2010-05-13 09:15:03
已阅   回复此楼   关注TA 给TA发消息 送TA红花 TA的回帖

老虎大王

木虫 (著名写手)
★ ★
小木虫(金币+0.5):给个红包，谢谢回帖交流
余泽成(金币+1):鼓励分享经验！ 2010-05-13 14:18:47
我就经常用data做变量名
不过，因为用vim写fortran程序，data这个词是高亮的，很刺眼，所以我有时候写成dat  
赞一下(2人) 回复此楼
5楼2010-05-13 10:27:35
已阅   回复此楼   关注TA 给TA发消息 送TA红花 TA的回帖
相关版块跳转 我要订阅楼主 yalefield 的主题更新
51/1返回列表
普通表情 龙 兔 虎 猫 高级回复 (可上传附件)
最具人气热帖推荐 [查看全部] 作者 回/看 最后发表
[硕博家园] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 8rmuugja8q 2026-02-22 7/350 2026-02-23 09:44 by w4l55oybr1
[考研] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 khieu8v8m0 2026-02-22 8/400 2026-02-23 09:35 by w4l55oybr1
[论文投稿] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +4 khieu8v8m0 2026-02-22 8/400 2026-02-23 09:29 by w4l55oybr1
[考研] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +5 usprnugpzw 2026-02-21 11/550 2026-02-23 09:24 by w4l55oybr1
[教师之家] 为什么中国大学工科教授们水了那么多所谓的顶会顶刊，但还是做不出宇树机器人？ +5 欢乐颂叶蓁 2026-02-21 8/400 2026-02-23 09:19 by 欢乐颂叶蓁
[论文投稿] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 w89i99eaeh 2026-02-22 5/250 2026-02-23 08:04 by w4l55oybr1
[博后之家] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +4 khieu8v8m0 2026-02-22 6/300 2026-02-23 07:59 by w4l55oybr1
[考博] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +4 khieu8v8m0 2026-02-22 4/200 2026-02-23 06:46 by jsjzfl
[公派出国] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 khieu8v8m0 2026-02-22 5/250 2026-02-23 06:29 by w4l55oybr1
[硕博家园] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +4 khieu8v8m0 2026-02-22 8/400 2026-02-23 06:24 by w4l55oybr1
[考博] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +5 3dfhjxgsh7 2026-02-22 6/300 2026-02-23 02:04 by 5jlh3qtdvx
[教师之家] 版面费该交吗 +7 苹果在哪里 2026-02-22 8/400 2026-02-22 22:37 by otani
[基金申请] 面上可以超过30页吧？ +4 阿拉贡aragon 2026-02-22 4/200 2026-02-22 21:22 by 山西悬空寺空悬�
[论文投稿] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +4 usprnugpzw 2026-02-21 6/300 2026-02-22 19:48 by w89i99eaeh
[考研] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 3dfhjxgsh7 2026-02-22 4/200 2026-02-22 16:52 by khieu8v8m0
[找工作] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 usprnugpzw 2026-02-22 3/150 2026-02-22 16:37 by khieu8v8m0
[公派出国] 售SCI一区文章，我:8 O5 51O 54,科目齐全,可+急 +3 usprnugpzw 2026-02-21 4/200 2026-02-22 16:27 by khieu8v8m0
[基金申请] “人文社科而论，许多学术研究还没有达到民国时期的水平” +4 苏东坡二世 2026-02-18 5/250 2026-02-22 16:07 by liangep1573
[基金申请] 什么是人一生最重要的？ +4 瞬息宇宙 2026-02-21 4/200 2026-02-22 11:44 by huagongfeihu
[基金申请] 今年春晚有几个节目很不错，点赞！ +11 瞬息宇宙 2026-02-16 12/600 2026-02-21 21:14 by lq493392203
信息提示
关闭
请填处理意见
关闭