1 使用可以准确说明变数/栏位/类的完整的英文描述符
例如,採用类似firstName,grandTotal 或 CorporateCustomer这样的名字。虽然象x1,y1或fn 这样的名字很简短,输入起来容易,但是我们难以知道它们代表什麽、结果是什麽含义,因而使代码难以理解、维护和改进。
2 採用该领域的术语
如果使用者称他们的“客户” (clients) 为“顾客” (customers),那麽就採用术语Customer 来命名这个类,而不用 Client。许多程式开发者会犯的一个错误是,不去使用工业或领域裡已经存在着很完美的术语时,却生造出一些普通词彙。
3 採用大小写溷合,提高名字的可读性
一般应该採用小写字母,但是类和介面的名字的首字母,以及任何中间单词的首字母应该大写。(驼峰式命名规则)
4 儘量少用缩写,但如果一定要使用,就要谨慎地使用
这意味着应该保留一个标准缩写的列表,明智地从中选取,并且在使用时保持一致。例如,想对单词“number”採用缩写,那麽可从 nbr,no 或者 num 中选取一个,说明一下採用了哪一个(具体是哪个倒无所谓),并且只使用这一种形式。
5 避免使用长名字(不超过15 个字母)
虽然 PhysicalOrVirtualProductOrService 看起来似乎是个不错的类名,但是这个名字太长了,应该考虑重新给它起个短一点的名字,比如象 Offering。
6 避免使用相似或者仅在大小写上有区别的名字
例如,不应同时使用变数名 persistentObject和persistentObjects及anSqlDatabase和 anSQLDatabase这样的名称
避免使用底线作为名字的首末字母
7 以底线为首末字母的名字通常为系统保留,除预处理定义之外,一般不用作用户命名。更重要的是,底线经常造成麻烦而且难输入,所以儘量避免使用。
评论列表
文章目录