标签 Naming 下的文章

再谈那些代码中的“中国式”命名

近期博客访问量提高了不少,分析了下原因,发现是有几篇近期写的文章被某个好心网友提交到dbanotesStartup News上了。与此同时,一些反馈也随之而来。从反馈来看,《那些代码中的“中国式”命名》一文似乎受到了更多的关注,或许是文章标题比较容易引起好奇的 缘故吧。但文章的本意仅是想阐述一些事实罢了,并没有“哗众取宠”的意思。网友的观点也促使我重新对“中国式”命名做了反思。

* “中国式”命名的普遍性

我曾天真地希望该问题只是我们项目中的个例,但现实是“沮丧”的。看到评论中几个网友都反馈“中枪”,说明该命名方式似乎是普遍存在于中华大地程 序员们的代码库中的。

中国式命名归跟结底是文化差异性和表达方式的问题,就和Chinglish一样。由于中式词汇、语法结构已经成为了我们的潜意识一部分,存在与大 脑的核心层,每当 我们要命名或表达一个事物时,大多数人首先在大脑中展现的是这个事物的中文拼写方式、中文语法的结构,其次才可能是英文的(对于第一外语是英语的人),如 果想不出正确的英文名并且懒得去求 谷哥,那么该事物在程序代码中就很可能以“中国式”的命名而存在着。

* 不是所有Chinglish都是English

在再次谈“中国式”命名之前,我们先要搞清楚:“不是所有Chinglish都是English”。

Chinglish刚出现的时候,标准英语的支持者认为Chinglish是垃圾,是错误的表达,无法被接受,对其进行抨击。但万事万物都有一个 接受的过程。今天来看,越来越多的选词达意准确的Chinglish词汇以及表达方式正在被国人接受甚至被以英语为母语的人所接受而成为 English,比如近年来的热词:geilivable(给力),再比如很早之前就接受的"long time no see"等。

作为人类的优秀语言,无论是英文还是中文,都具有很强的开放性和包容性。随着时代的变迁,新生事物的出现,词汇与表达方式都是在语言间相互渗透, 相互补充的。比如随着近些年中国航天事业的迅猛发展,尤其是神舟飞船的多次成功发射,标准英语中接纳了“中国宇航员”这个词 汇:taikonaut;再比如很可能于明年被收录到牛津英语词典中的”Tuhao(土豪)”、 “Dama(大妈)”和“Hukou(户口)”等。而近些年来,一些外词的音译中文词汇也被加入汉语词典了,比如博客 (blog)、粉丝(fans)等。

但不是所有Chinglish都可以被接受而成为English的。Chinglish是良莠不齐的,那些完全错误的、让人啼笑皆非的词汇和表达 方式现在不会被接受,以后也是不会被接受的。比如下面这两个典型的错误:

    杯子 – Cup son
    开水房 – Open Water House

* 用Chinglish != "中国式"命名

既然“中国式”命名是普遍存在的,那是否是合理的呢?在上一篇文章中,我个人将其归类为bad smell一类,现在的观点依旧如此。

有人不禁要问:既然有些中国式英语(Chinglish)都能被老外所接受,那“中国式”命名为何不可呢?

我的答案如下:在代码中使用已经被老外接受了的Chinglish词汇,实际上与使用地道英文词汇本质上是相同的,算不上“中国式”命名;这里的 “中国式”命名仅针对我在上一篇文章中提到的那些命名方式,当然包括那些并未被广泛接受的Chinglish词汇和使用方法。

* 对"中国式"命名的态度

网友观点:“认真你就痛苦了”。
我倒不是这么想的。既然我们认为命名在编码过程是重要的、困难的,我们就更是要认真对待,在这方面我们有些时候真得较较真儿。我想这也是专业性的 一种体现。

* 到底该如何做?

一句话:尽可能用English(编程界主流文化在欧美,主流语言是英语,这才是根本原因),包括那些广泛接受的Chinglish。纯自造的 “词汇”,比如网友评论中提到的left_kuohao这种中英结合词还是不写为好。

如果有一天中文编程语言成为编程界的主流,那中国程序员也就不用在命名上纠结了。

那些代码中的“中国式”命名

10月中旬,有人在Quora网站上发起一个调查:“程序员职业生涯中最难的事是什么?”,调查结果让人实感意外。世界范围内的程序员同胞们普遍认为: “命名是让大家感觉最困难的事情”。对于主流的欧美程序员尚且如此,对于英文非母语的中国程序员来说,苦逼程度可想而知了:(。

虽说中国程序员大多也都学了10年以上的英语了,但能“地道”的表达和书写甚至是选词的程序员们比例却不高。而在编写程序的过程中,给变量、常量以及函数命名即意味着我们要选择恰当地道的词汇或缩写。

事实证明,任何事情经过中国人民的加工,就会呈现出意想不到的效果,于是我们有了Chinglish,有了“中国式”的命名。就此,我特地花了些时间翻阅了下面几个项目组的源码,总结出了一些“中国式”命名的门道,这里也说道说道^_^。

一、万能的动词

通过阅读代码中的一些命名,我发现了代码中经常出现的一些动词堪称“万能”,这些动词包括:handle、do、process、check、collect等。无论对象是什么,你只要像如下这么命名,中国程序员基本都能看懂或猜个八九不离十:

    process_xx  处理xx
    do_yy       做yy
    handle_zz   处理zz
    check_xx    检查/校验xx
    collect_xx 收集xx

二、标志/类型代言人

在项目源码文件中,你会变量声明或结果体声明中看到太多的xx_flag或xx_type。xx_flag被大家“公认为”各种标志的代言人了;xx_type也好不到哪去。

    route_flag
    protocol_flag
    msg_flag
    session_flag

    msg_type
    check_type
    command_type
    session_type

三、字面意直译式

比如我们要声明两个变量,一个的意思是“是否打开消息过滤”,另外一个“是否关闭消息过滤”。对于中国人来说,打开/关闭最直接对应的就是open/close,于是就有了这样的变量命名:

    is_message_filter_open
    is_message_filter_close

其实一般认为更地道的方式应该是:

    is_message_filter_on
    is_message_filter_off

再举个例子,我们的系统要处理一种中文名为“长短信”的对象,于是直译过来就是:long_sms。但其真正的英文术语应该是Concatenated SMS

四、中文拼音式

在国内做行业解决方案,不可避免会遇到各种领域词汇,比如我们处理的一种业务称为农信通。估计是开发人员没能找到其对应的英文翻译,于是乎用上了我们的看家本领 – 拼音。

    nxt_url  农信通地址

这样的例子是否似曾相识呢!

五、单词“选秀”

采用这种方式的程序员应该是更具“责任心”的,至少他/她知道去查查英文词典^_^。

于是乎有了dispense_message、cache_overstock等变量命名。显然他是在字典的单词选秀中随意找到一个“顺眼”的、意思还算相近的单词就挑了出来。显然dispatch 、overflow要比dispense、overstock更地道和准确。

六、尾声

以上的“实例”确是从我们项目的代码中“挖掘”出来的,希望只是个案。面对这样的命名bad smell,我们是否有解决方法呢?没有捷径,语言的感觉是要一点点的去找的,个人觉得一个最行之有效的方法就是去看那些英语地道的程序员编写的代码,留 意他们是如何命名的。比如看一些著名欧美程序员的开源项目代码。另外对于行业特定领域,尽量用经过认可的英文翻译结果来命名。

不可否认,英语是编程领域的主流语言,包括中文在内的以其他语言为编码语言的编程语言十分罕见。对于欧美程序员来说,这是天然的优势;而对于其他非欧美国家的程序员,尤其是中国程序员来说,在走向“地道”的路上还要付出很多才行。

如发现本站页面被黑,比如:挂载广告、挖矿等恶意代码,请朋友们及时联系我。十分感谢! Go语言第一课 Go语言精进之路1 Go语言精进之路2 Go语言编程指南
商务合作请联系bigwhite.cn AT aliyun.com

欢迎使用邮件订阅我的博客

输入邮箱订阅本站,只要有新文章发布,就会第一时间发送邮件通知你哦!

这里是 Tony Bai的个人Blog,欢迎访问、订阅和留言! 订阅Feed请点击上面图片

如果您觉得这里的文章对您有帮助,请扫描上方二维码进行捐赠 ,加油后的Tony Bai将会为您呈现更多精彩的文章,谢谢!

如果您希望通过微信捐赠,请用微信客户端扫描下方赞赏码:

如果您希望通过比特币或以太币捐赠,可以扫描下方二维码:

比特币:

以太币:

如果您喜欢通过微信浏览本站内容,可以扫描下方二维码,订阅本站官方微信订阅号“iamtonybai”;点击二维码,可直达本人官方微博主页^_^:
本站Powered by Digital Ocean VPS。
选择Digital Ocean VPS主机,即可获得10美元现金充值,可 免费使用两个月哟! 著名主机提供商Linode 10$优惠码:linode10,在 这里注册即可免费获 得。阿里云推荐码: 1WFZ0V立享9折!


View Tony Bai's profile on LinkedIn
DigitalOcean Referral Badge

文章

评论

  • 正在加载...

分类

标签

归档



View My Stats