编码之道：取个好名字很重要（转）

代码就是程序员的孩子，给“孩子”取个好听的名字很重要！

　　我们在项目开发中，接触到的变量、函数、类多数都是项目自己定义的，往往都是为了解决一些特定的领域的问题，引入了各种各样的概念，代码里面的名字就对应着问题领域或方案领域的这些概念。所以，对于一个命名良好、代码规范、设计简洁的系统，要想非常快的理解一个系统，最直接的方式就是RTFC(Read The Fucking Code)。对于一个不断演进的系统，代码的可读性至关重要，首要要解决的问题就是名字，变量名、函数名、类名等都需要仔细斟酌，认真对待，一个能够简洁，能够清晰表达概念和意图的名字就显得尤为重要。

　　阅读《代码整洁之道》这本书后发现其中说的内容在我们自己项目中比比皆是，随便拿出一块代码都可以当做反面教材给大家讲半天。长时间积累，导致代码发霉变质，取名也是毫无章法，信手拈来。阅读这样的代码，撞南墙的心都有了。下面结合自己项目中的问题和《代码整洁之道》谈谈关于命名相关的原则。

　　1. 原则：名副其实

• 选名字是件严肃的事情，选个好名字很重要。
• 如果名字需要注释来补充，那就不是个好名字。
• 最重要的是要名副其实，名字能表达出概念和意图。

　　BAD:

int t = currentTime.elapse(e); // 消逝的时间,以毫秒计
...
if (t > timeout_value)
{
   Zebra::logger->debug("---一次循环用时 %u 毫秒-----", t);
}

GOOD:

int elapsed_ms = currentTime.elapse(e);
...
if (elapsed_ms > timeout_value)
{
   Zebra::logger->debug("-----一次循环用时 %u 毫秒---", elapsed_ms);
}

2. 原则：避免误导

• 必须避免留下掩藏代码本意的错误线索
• 避免使用与本意相悖的词
• 提防使用不同之处较小的名称
• 拼写前后不一致就是误导

　　BAD:

std::vector<int> account_list; // _list就是一个误导, accounts会更好
bool sendToZoneServer(); // 和下面的函数差别很小
bool sendToZoneServers(); // sendToAllZoneServers会好点

　　3. 原则：做有意义的区分

• 代码是写给人看的，仅仅是满足编译器的要求，就会引起混乱。
• 以数字系列命名(a1,a2,...)，纯属误导。
• 无意义的废话: a, an, the, Info, Data

　　BAD:

void copy(char a1[], char a2[]) {
  for (size_t i = 0; a1[i] != '