1.名副其实
变量、函数或类的名称应该答复了所有的大问题。比如它为什么存在，它做什么事情，应该怎么用。如果名称需要注释来补充，那就不是名副其实。
int d;// 消逝的时间，以日计
名称d什么野没说明，他没有引起对时间消逝的感觉，更别说以日计。
我们应该指明计量对象和计量单位的名称：
int elapsedTimeInDays;
int daysSinceCreation;
int daysSinceModification;
int fileAgeInDays;
2.避免误导
程序员必须避免留下掩藏代码本意的错误线索。应当避免使用与本意相悖的词。
别用accountList来指称一组账号，除非它真的是List类型。List一词对程序员有特殊意义。
提防使用不同之处较小的名称。
XYZControllerForEfficientHandlingOfString 和另一处 XYZControllerForEfficientStorageOfString ,区分起来会很花时间。
3.做有意义的区分
如果程序员只是满足编译器或解释器的需要而写代码，就会制造麻烦。
例如，因为同一作用范围内两样不同的东西不能重名，你可能会随手改掉其中一个的名称。有时干脆以错误的拼写充数，结果就是现在更正拼写后导致编译器出错的情况。
public static void copyChairs(char a1[],char a2[]) {
for(int i = 0, i < a1.length, i ++) {
a2[i] = a1[i];
}
}
如果修改名称为source和destination，这个函数就会像样许多。
废话是另一种没有意义的区分。假如你有两个Product类，还有一个叫ProductInfo 或者 ProductData 类，那他们的名称虽然不一样，意思却无区别。
4.使用读得出来的名称
人类长于记忆和使用单词，名称读不出来，感觉就是沟通困难。
有家公司，程序里面写了一个 genymdhms（生产日期，年、月、日、时、分、秒），他们一般读作“gen why emm dee aich emm ess”即字母的读音，有见字读音的习惯就会读成“gen-yah-mudda-hims”。后来人根本不知道这个名词的意义。这是自造词，而非恰当的英语词。
class DtaRcrdl02 {
private Date genymdhms;
private Date modymdhms;
private final String pszqint = "102";
...
};
class Custmer{
private Date generationTimestamp;
private Date modificationTimestamp;
private final String recordId = "102";
...
}
5.使用可搜索的名称
单字母名称和数字常量有个问题，就是很那在一大篇文字中找出来。
找MAX_CALSSES_PER_STUDENT 很容易，找到一个数字7就很困难了。
6.避免使用编码
编码已经太多，无畏再自找麻烦。
把类型或作用域编进名称里面，徒然增加了解码的负担。带编码的名称也不方便发音，容易打错。
PhoneNumber phoneString;// 类型变化时，名称并不变化
有时会出现采用编码的特殊情形。比如，你在做一个创建形状的抽象工厂（AbstractFactory）。该工厂是个接口，要用具体的类来实现。怎么命名呢？IShapeFactory 和 ShapeFactory 吗？肯定ShapeFactory。前缀字母I被滥用，说好听是干扰，说难听点就是废话的程度。
7.避免思维映射
不应当让读者在脑中把你的名称翻译成他们熟知的名称。明确是王道。
8.类名
类名和对象名应该是名词，不应当是动词
如 Custmer，WikiPage，Account等，避免使用Manager、Processor、Data或Info这样的类名。
网友评论