Utils文件是好的做法吗？ [关闭]

Question

我看到很多项目都使用这种文件。它通常包含代码中很多地方需要的函数。从包含一两个函数的类和命名空间的数量中保存代码似乎是合乎逻辑的。但另一方面，它使代码更少地分成逻辑部分，从而更难理解项目的结构。那么我的问题是什么。在项目中有这样的文件是好是坏？

我使用的语言是 c++，但问题似乎涉及任何编程语言。

Answer 1

utils 文件是否是不好的做法取决于许多因素。 其他因素是（并且列表并不详尽，可能会受到不同个人的意见）：

• 它是否包含逻辑上属于一起的函数。或者那里有没有的功能。后者当然是不好的做法。
• 它是否是命名良好的命名空间的一部分，以明确 utils 的用途。
• 除了命名空间结构之外，还有目录结构
• 单元测试显示实用程序的工作方式以及用户应该如何使用 api。
• 如果您能找到一个比简单的 utils 更好的名称，请务必这样做。
• 这些 utils 文件可以多种形式出现，服务也一样好。
• 命名良好的类和函数名、变量...

结论：它的好坏很大程度上取决于更广泛的上下文和相关文件的内容。干净代码的规则始终适用。将实用程序函数放在单独的文件中的想法是常见的做法，但它们只有在结构非常好的情况下才有用，这样人们就可以很容易地找到它们的方法，并且很容易找到它们。如果这没问题，人们会使用它们。否则人们将不会使用它们，并且您最终仍会得到许多 utils 文件，这些文件仍然包含大量重复，实现略有不同。