如何给程序中的变量起个好名字

正文

请到「今天看啥」查看全文

int elapsedTimeInDays;
int daysSinceCreation;
int daysSinceModification;
int fileAgeInDays;

避免会被误解的命名

导致误解的信息比没有信息更糟糕，有些程序员喜欢“隐藏”一些重要信息，但更糟的是，他们有时会写出一些让人误解的代码。

不好的代码：
Customer[] customerList;
Table theTable;

变量“customerList”其实不是个list。它只是一个普通的数组（集合）。第二行中，“theTable”是一个Table类的对象，“the”这个词是个不必要的干扰。

清晰的代码：
Customer[] customers;
Table customers;

适合的名字长度

在现代的编程语言中，很长的变量名字是被允许的，你可以基本不受限制的去命名，但是这样会导致命名的混乱。

不好的代码：
var  theCustomersListWithAllCustomersIncludedWithoutFiler;
var  list;

好的名字应该包含足够的单词来表达意思，但是任何不必要的词都会使名字变长，变得难以理解。名称越短越好，前提是能在上下文中表达完整的意思。

清晰的代码：
var allCustomers;
var customersInOrder;

符合“代码规范”，可以更好的帮助理解

所有的编程语言都有自己的“风格”，叫做表示法。程序员应该写出符合这种表示法的代码，因为其他的程序员也知道这点，并按这种风格写程序。我们来看一个不符合表示法的不好的代码例子。下面的这段代码没有遵循任何代码标准（比如PascalCase, camelCase, Hungarian规范）。更糟糕的是，这里有一个无意义的bool型变量change，这是个描述动作的动词，但这里的bool值应该表示一种状态，所以这个变量应该用一个形容词来命名。

不好的代码：
const  int maxcount = 1;
bool  change = true;

请到「今天看啥」查看全文