优雅的命名

Posted glsy

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了优雅的命名相关的知识,希望对你有一定的参考价值。

代码中随处可见我们的命名:变量、函数、类、包等,我们无时无刻不在命名和使用自己命名。优雅的命名必须满足一下要求。

1.自解释的命名,不需要注释就能看懂

2.拒绝类似具有误导性的命名

3.拒绝没有意义的命名(例如: a1,a2; aName, theName; customer, customerInfo; account, accountData 这些命名都是无意义的,无法区分的命名)

4.使用朗朗上口、可读性强的单词或词组,再不济也要用拼音,不能自造词(例如:genrationymdhms 就没有 generationTimestamp好)

5.使用能够搜索的名称,拒绝使用单字母命名、数字常量硬编码,单字母可能在代码中出现很多次,难以确定你要求的代码,数字常量硬编码和单字母一样难以搜索,

  就算拉长数字位数,如果其他人修改了,也难以找到。一般要通过定义常量或变量标识符标识字面量

6.类名、对象名和变量名一般使用名词或名词短语;方法名一般使用动词后动词短语。

7.每个概念都选择一个词,不要采用多种形式表达(例如:get,fetch,retrieve 都能表是获得,只需要选择一个用在程序中,拒绝在程序中使用多种表示方法)

8.命名要精确不要拖泥带水(例如:项目名叫ABC,项目中的所有类都命名为ABC开头的,这种做法是有问题的,因为如果我们去搜索ABC,会出现很多的条目,会让你感到疲倦)

 

每个人都要学会养成优雅命名的规范,使自己形成习惯,这样以后开发中就可以避免很多不必要的问题。

以上是关于优雅的命名的主要内容,如果未能解决你的问题,请参考以下文章

教妹学Java:技术大佬的必备素质,命名优雅

优雅的方法来防止C ++中的命名空间中毒

编程实践这个代码命名规范是真优雅呀!代码如诗!!(多读优秀的开源代码,多实践,你也可以一样优秀!)

如何优雅地重命名 Ruby 中哈希中的所有键? [复制]

如何“优雅”地给你的类命名

优雅整洁的 Java 代码命名技巧,风之极·净化