如何给程序中的变量起个好名字？ 作者 | Daan 译者 | 王文刚 编辑 | 陈思 AI 前线导读：作为开发人员，你要花费大量的敲代码时间来创建变量和考虑给变量起个名字。名字无处不在。你可以命名文件、类、方法和变量。而命名的不同导致有的是好代码，有的是糟糕的代码，最终这会严重影响代码维护的成本。 由于我们花费大量时间命名变量，因此做好它非常重要。在本文中，作者将向你展示一些简单的规则，你可以遵循这些规则来创建名字。在代码中起名本身就是一门艺术！ 更多优质内容请关注微信公众号“AI 前线”（ID：ai-front） 1、名字要显示真正意图 这说起来容易做起来难。你多久遇到一次变量名，而这些变量名没有告诉你有关变量的真实信息？ 一个好的经验法则是：如果一个名字需要注释，那么它并不是真实意图的命名。 编程大师 Robert C. Martin 在《Clean Code》中说道：“使用注释是为了弥补我们代码表意上的不足。” 这句话意味着如果你的代码需要添加注释，就说明你的代码还不够好。同时，这也说明如果不能在单纯的代码中展示你对问题或算法的理解，这是非常失败的，你只能依靠一些注释说明你的想法，而不能仅用代码。 优秀的代码可以让人在没有注释的情况下看懂并理解，好的编程习惯也是让所有必要的信息都在代码中展示出来。 以下代码段是一个变量，它不能揭示真正的意图： ?php private $s; // Time in seconds 变量 $s 没有显示任何意义。 它不会看到任何时间流逝的含义。最好选择一个名称，该名称指定要测量的内容以及该测量的单位。因此，很重要的一点就是，程序员要用代码准确的表达出自己的思想，从而让其他人明白程序的含义。 下面的示例中的变量名会更好，任选其一。 ?php private $days_since_creation; private $elapsed_time_in_seconds; private $seconds_since_last_modified; 选择显示意图的名称可以使理解一段代码变得更加容易，因此也易于维护。选择名字需要时间，但是比起维护代码，整体节省时间要多得多。 让我们看一下以下示例： ?php function getList() { $list1 = []; foreach ($this-the_list as $x) { if ($x % 2 != 0) { $list1[] = $x; } } return $list1; } function getOddNumbers() { $odd_numbers = []; foreach ($this-numbers as $number) { if (isOdd($number)) { $odd_numbers[] = $number; } } return $odd_numbers; } 为什么 getList 函数的作用这么难辨别？它并没有复杂的表达式。代码已缩进并正确格式化。只使用了三个变量，没有花里胡哨的东西。 再看一下 getOddNumbers 函数。你是否看到该函数与 getList 函数完全相同？ 注意，代码的复杂度没有改变。它仍然具有完全相同数量的运算符和变量，以及完全相同数量的嵌套逻辑。唯一改变的是代码命名变得更加明确。通过简单的名称重构，我们很容易分辨出这段代码的功能。 2、使用某一领域背景中有意义的名字 程序员写的所有代码都是和某一领域背景相关的，为了让写出的代码可以让个更多的人理解，最好使用该领域背景下的名字。 不好的代码示范： public class EntitiesRelation { Entity o1; Entity o2; } 当你在编写针对某个领域的代码时，你应该使用领域背景相关的名字。如果以后有另外的人（不仅是程序员，也许是测试人员）接触你的代码时，他能轻松的理解你写背景相关的代码含义。 所以，程序员首先应该考虑的是领域背景问题，之后才是如何出解决方案。 清晰的代码示例： public class ProductWithCategory { Entity product; Entity category; } 3、避免误导信息 你应该避免留下掩盖代码含义的错误提示。避免误导其含义与预期含义有所差异的词。例如，不要将产品分组称为 productList，除非它实际上是 List 类型的对象。这可能导致错误的结论。命名为 products 更好。 Product[] products; 你可能选择的最差的变量名称是大写的 O 和小写的 L。这是因为它们看起来很像 0 和 1。 当心使用名称变化很小的名称。发现一个文件中的 SomeMethodForEfficientHandlingOfFiles 和另一个文件中的 SomeMethodForEfficientStorageOfFiles 之间的细微差别需要多长时间？乍一看，这些名称看起来相同。 导致误解的信息比没有信息更糟糕，有些程序员喜欢“隐藏”一些重要信息，但更糟的是，他们有时会写出一些让人误解的代码。 命名混淆：一个词不要表示多种概念 定义场景中的概念很难，在软件开发过程中，程序员需要花费很多时间去分析某一场景，并命名场景中的各种元素，这样的工作永远都是让程序员头疼的事情。不好的代码示例： //1. void LoadSingleData(); void FetchDataFiltered(); void GeteAllData(); //2. void SetDataToView(); void SetObjectValue(int value); 在第一段代码中，这个程序员想表达“获取数据”这个概念，但他用了很多不同的词”load”，”fetch”, ”get”。在一个场景下，应该用一个统一的词表示这个概念。 在第二段代码中，”set”一词被用作了两个概念，第一个是“取出数据显示”，第二个是“为一个对象赋值”，应该用不同的词表示这两个不同的概念。 清晰的代码示例： //1. void GetSingleData(); void GetDataFiltered(); void GetAllData(); //2. void LoadDataToView(); void SetObjectValue(int value); 4、做出有意义的区分 数字系列命名不是一个命名的好方法。这样的名称是非信息性的，因为它们没有提供代码作者意图的任何提示。 让我们看下面的例子： ?php public function duplicateArray($arr1, &$arr2) { foreach ($arr1 as $key = $value) { $arr2[$key] = $value; } } 当将 $ arr1 和 $ arr2 重命名为 $ source 和 $ destination 时，此代码将更好地阅读。 5、使用可以发音的单词 如果不能说出名字，那么你就不能在听起来像个白痴的情况下讨论它。这实际上很重要，因为编程的一部分工作是社交活动，每个人都有很大的机会知道自己无法发音的变量名称。假设我们有一个名为 $xsq 的变量名，这对贵公司来说是一个非常重要的缩写。想象一下与同事的对话： “嘿，那可变的 eks ess kjew 呢？” “你是说访问队列？” 一些开发人员将尝试将变量发音为一个单词。其他人会拼出这个词。 变量命名：使用在上下文有意义的名字 代码里的名字都有自己的上下文，上下文对于理解一个代码是很重要的，因为它能提供额外的信息。我们来看一个典型的“地址”上下文： 不好的代码示例： string addressCity; string addressHomeNumber; string addressPostCode; 在大多数情况中，“邮政编码”（PostCode）是地址的一部分，很显然，邮政编码不能单独使用（除非你是在开发一个专门处理邮编的应用）。所以，没有必要在“PostCode”的前面加上“address”。而且，所有的这些信息都应该有一个上下文环境，在面向对象编程中，这里应该用一个“Address”类来表达这个地址信息。清晰的代码示例： class Address { string city; string homeNumber; string postcode; } 6、使用可搜索的名称 由一个字母组成的名称，可能存在难以定位的问题。 数字常量也是如此。数值常量可以用常量变量代替。搜索代码时，数字 8 可能会给你带来很多麻烦。但是，用常量 MAX_BLOCKS_DISPLAYED 替换它会使它变得更容易。 单字母名称的唯一用例是简短方法中的局部变量。 7、命名前缀 不要使用前缀。 例如，某些开发人员习惯在所有私有成员前面加上下划线。别，你的类和方法应该足够短小，以至于不需要任何这些前缀。 或者，你可以使用 IDE（或安装插件），该 IDE 根据变量的范围会为变量着色。 结论 这样，你可以在代码中创建更有意义的名称。 作为一名程序员你应该： 1、起的名字有意义，可以表达一个概念 2、要考虑名字的长度，名称中只有必要信息 3、符合“编码规范”，有助于理解 4、一个概念不要多个名字混用 5、使用在背景领域和上下文中都有意义的名字 本文的灵感来自罗伯特·C·马丁（Robert C. Martin）所著的《清洁代码》（Clean Code），我强烈建议你仔细阅读。 英文原文： https://medium.com/better-programming/how-to-create-meaningful-names-in-code-20d7476537d4 你也「在看」吗？?? 阅读原文