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

我希望有一种工具可以与数据字典(描述各种变量/方法名称的文件，我猜有点像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 /系统工程师，负责少量的软件工作，最后我真的不关心变量的名称，只要我有一种方便的方法来告诉它是什么，并将它映射到我自己的被控制系统的内部模型。

Steve Mcconnell的《Code Complete》一书中有一个关于命名变量/类/函数/…

不，调试对我来说是最困难的事情!: -)

如果10个人中有8个人理解它，那么你就可以放心地认为它是可以理解、可读和清晰的。总会有那么一两个挑剔的人，他们会毫无理由地找你的茬，只因为他们太小气。

DocumentFetcher吗?没有上下文很难说。

它可以帮助你像数学家一样，在你的领域中借用/发明一个词汇:使用简短的简单的词来暗示概念，而不是每次都拼写出来。我经常看到长拉丁短语变成首字母缩略词，让你需要一本字典来了解这些首字母缩略词。

我从另一个角度来看，如果你想让你的代码被其他人读懂，这是最重要的事情之一。

尽量使它具有描述性，如果它来自第三方，为什么不在类或方法名中包含[第三方的]名称呢?

如果嫌时间长，随便取个名字，后记可以改。