26、代码命名、测试与并发编程的最佳实践

代码命名、测试与并发编程的最佳实践

1. 代码命名原则

1.1 明确的命名

选择能让函数或变量的功能明确无误的名称。例如，在 FitNesse 中有如下代码：

private String doRename() throws Exception
{
  if(refactorReferences)
    renameReferences();
  renamePage();
  pathToRename.removeNameFromEnd();
  pathToRename.addNameToEnd(newName);
  return PathParser.render(pathToRename);
}

这个函数名 doRename 没有清晰表明函数的具体功能，且函数内部还有 renamePage 函数，让人难以区分两者的差异。更好的命名可以是 renamePageAndOptionallyAllReferences ，虽然长，但能准确描述函数功能，且该函数在模块中仅被调用一次，解释性价值大于长度带来的影响。

1.2 长作用域使用长名称

名称的长度应与作用域的长度相关。对于小作用域，可以使用非常短的变量名；对于大作用域，则应使用较长的名称。例如在“Bowling Game”中有如下代码：

private void rollMany(int n, int pins)
{