选择一个合适的名字

Question

我知道选择一个恰当的名字来反映你的意图何时可能，以及它如何影响你的代码质量是多么重要。

例如，下面是一些方法java.math.BigDecimal中，我认为有一个有趣的参数名：

BigDecimal add(BigDecimal augend); 
BigDecimal divide(BigDecimal divisor, int scale, RoundingMode roundingMode); 
BigDecimal multiply(BigDecimal multiplicand); 
BigDecimal subtract(BigDecimal subtrahend); 

这样的方法总是让我意识到，知道一些特定的符号和术语是一个伟大的有助于改善你的代码，因此我认为如果我更好地了解它们会很好。

最近我找到a really good website，它给出了数学中常用术语的列表，我想知道是否有任何类似的资源（无论是在网络，物理还是其他与编程相关的领域）都可以提高词汇量作为程序员？

请记住，我这里所指的不是编码标准，例如Zend Naming Conventions。

Answer 1

我觉得Wikipedia是一个很好的资源。

例如，当我需要一个变量来存储am或pm时，我以前称其为ampm。

一会儿回来，I looked into it现在把它命名为meridiem。

Answer 2

我想说，有多个领域的词汇表可能有助于找到好的条款，但通常这也是您的团队为自己设定的经验和惯例的问题。

命名的一个问题是，其他人读取名称可能不知道如何解释它，因此你至少应该添加一个解释类/字段/方法含义的注释。

除此之外，我建议根据他们的目的或他们使用的算法来命名这些方法，例如， sort或quicksort。如果您从特定区域实施算法，则应熟悉该区域或至少该算法，从而减少命名问题。 （例如：如果我实现了一种方法来计算两个字符串的levenshtein distance，我会将这个方法命名为int calcLevenshtein(String arg1, String arg2)）。