为什么不叫HelpDocumentServiceClient有点拗口，或者叫HelpDocumentClient…它是供应商并不重要，重要的是它是处理帮助文档的web服务的客户端。

是的，命名很难。

我学到的一个教训是，如果你找不到一个类的名字，那么这个类几乎总是有问题:

你不需要它 它做的太多了

你用来描述问题的语言，就是你应该用来描述变量、方法、对象、类等的语言。一般来说，名词匹配对象，动词匹配方法。如果您缺少描述问题的词语，那么您也缺少对问题的全面理解(规范)。

如果它只是在一组名称中进行选择，那么它应该由您用来构建系统的约定来驱动。如果您遇到了以前的约定所没有发现的新情况，那么总是值得花一些精力尝试扩展它们(适当地、一致地)来覆盖这个新情况。

如果有疑问，那就睡一觉，选一个最明显的名字，第二天早上:-)

如果有一天你醒来发现自己错了，那就马上改变。

保罗。

BTW: Document.fetch()是非常明显的。

我能感受到你的痛苦。：/

我希望有一种工具可以与数据字典(描述各种变量/方法名称的文件，我猜有点像javadoc)一起检查源代码，这样你就可以编写这样的代码:

class Battery 
{
   double I; // current
   double T; // temperature
   double V; // voltage
   double Q; // charge

   void update(double Inew, double dt) { I = Inew; Q += I*dt; }
   // ... etc ...
};

and the code-reviewing tool could do a number of different things to make it easier to view code in context, including display reminders that I = current (e.g. in a pane on the right-hand-side of the window it would display variable definitions/semantics/comments for the place in the code you are clicking on), or even allow you to do "virtual refactoring" where as a code reviewer you could rename something to your liking for readability/display reasons without actually changing the code stored on disk.

就像我喜欢自我描述名字一样，我讨厌读像BatteryFilteredCurrentInMilliamps这样的东西。通常在嵌入式系统中，我们是基于代数方程来建模对象的，这样的方程名称非常麻烦。(另一方面，“I”上面有一顶帽子，下标“d”和上标“*”是相当令人困惑的。)

我首先是一个EE /系统工程师，负责少量的软件工作，最后我真的不关心变量的名称，只要我有一种方便的方法来告诉它是什么，并将它映射到我自己的被控制系统的内部模型。

我觉得这不难。如果你叫不出名字，也许你就不需要它。你的设计越好，你就越容易为你的设计命名。

现在来看临时变量，这是另一回事了。：）

同意了。我喜欢让我的类型名称和变量尽可能具有描述性，而不太长，但有时只是有一个特定的概念，你找不到一个好的词来形容。

在这种情况下，向同事寻求帮助总是有帮助的——即使他们最终没有帮助，它通常至少能帮助我大声解释出来，让我的车轮转动起来。