简而言之: 我同意好名字很重要，但我不认为你必须不惜一切代价在实现之前找到它们。

当然，最好一开始就有个好名字。但如果你不能在2分钟内想出一个，以后重命名将花费更少的时间，从生产力的角度来看是正确的选择。

长: 一般来说，在实现之前对名称考虑太久通常是不值得的。如果你实现你的类，命名它为“Foo”或“Dsnfdkgx”，在实现的时候，你会看到你应该给它命名什么。

特别是在Java+Eclipse中，重命名一点也不麻烦，因为它会小心地处理所有类中的所有引用，并警告您名称冲突等。只要这个类还没有在版本控制存储库中，我不认为重命名5次有什么错。

基本上，这是一个如何思考重构的问题。就我个人而言，我喜欢它，尽管它有时会惹恼我的队友，因为他们相信永远不要碰一个运行系统。从您可以重构的所有内容来看，更改名称是您可以做的最无害的事情之一。

这是有编码标准的原因之一。有一个标准往往有助于在需要时想出名字。它有助于解放你的思想，让你去做其他更有趣的事情!(-):

我建议阅读Steve McConnell的《Code Complete》(Amazon链接)的相关章节，其中介绍了一些有助于提高可读性甚至可维护性的规则。

HTH

欢呼,

Rob

好的命名约定应该尽量减少任何给定变量、类、方法或函数可使用的名称数量。如果只有一个可能的名字，你永远不会有困难记住它。

对于函数和单例类，我仔细检查函数，看看它的基本功能是否将一种东西转换为另一种东西。我对这个术语的使用非常宽松，但你会发现你写的大量函数本质上是以一种形式的东西产生另一种形式的东西。

在您的例子中，这听起来像是您的类将Url转换为Document。这样想有点奇怪，但完全正确，当你开始寻找这个模式时，你会到处看到它。

当我找到这个模式时，我总是将函数命名为xFromy。

因为您的函数将Url转换为Document，所以我将它命名为Document

DocumentFromUrl

这种模式非常普遍。例如:

atoi -> IntFromString
GetWindowWidth -> WidthInPixelsFromHwnd // or DxFromWnd if you like Hungarian
CreateProcess -> ProcessFromCommandLine

你也可以使用UrlToDocument如果你更喜欢这个顺序。不管你说的是xFromy还是yTox，可能都是个人喜好的问题，但我更喜欢From顺序，因为这样函数名的开头就已经告诉了你它返回的类型。

选择一个惯例并坚持下去。如果注意在xFromy函数中使用与类名相同的名称，就会更容易记住所使用的名称。当然，这种模式并不适用于所有情况，但它确实适用于您编写的可以被认为是“功能性”的代码。

对我来说，我不在乎一个方法或类名有多长，只要它是描述性的，并且在正确的库中。应该记住API的每个部分驻留在哪里的日子已经一去不复返了。

智能感存在于所有主要语言中。因此，当使用第三方API时，我喜欢使用它对文档的智能感知，而不是使用“实际的”文档。

考虑到这一点，我可以创建一个方法名，如

StevesPostOnMethodNamesBeingLong或Short

很长，但那又怎样。现在谁不用24英寸的屏幕呢!

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

是的，命名很难。

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

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