什么时候不应该将我的代码拆分成头文件和源文件？

Question

我知道这可能是非常主观的,但是当代码不必分成两个文件时,是否有任何通用规则？

例如,类是非常小的,还是文件只包含一些全局定义或静态函数？此外,在这些情况下,单个文件应该是.cpp文件还是.h文件？

Answer 1

在技​​术方面,每当您需要遵守一个定义规则时,您必须将声明与定义分开,因为您需要在多个转换单元中多次包含声明,但您必须只提供一个单一定义.

在美学方面,答案可能是"总是"或"系统地".在任何情况下,你应该始终有一个首标为每一个代码的逻辑单元(例如一个类或功能中的一个集合); 并且源文件可能是可选的,具体取决于您是否具有内联定义的所有内容(免除ODR),或者您是否有模板库.

作为元策略,您应该尽可能地将编译单元分离,以便您只能以细粒度的方式包含所需的内容.这使您的项目得以增长,而不会使编译时间变得难以忍受,并且使得在其他项目中重用代码变得更加容易.

Answer 2

我喜欢将代码放入 .hpp 文件中，但由于以下原因，我经常被迫将实现放入 .cpp 中：

1. 减少构建时间。这是使用 .cpp 文件的第一大原因...并且您在 .hpp 文件中找到的大多数代码都小而简单。当实现发生变化时，您不希望必须重建包含它的每个 .cpp。
2. 当功能的链接很重要时。例如，如果函数导出为库（例如 DLL）函数，则选择驻留在其中的单个编译单元非常重要。或者对于静态/全局实例。这对于分发 DLL 的导入标头也很重要。
3. 当您希望在分发库时隐藏实现细节时
4. 定义和声明不相同。对于参数的常量性来说可能就是这种情况。
5. 您希望 .hpp 文件中的界面有一个“干净”的概述。我发现，随着现代代码工具以及对单代码文件语言（如 javascript / C# / 内联 C++）的日益熟悉，这并不是一个有力的论据。
6. 您明确不希望声明该函数inline。虽然，这并不重要；如果需要的话，优化编译器可能会内联。

将代码内联在 .hpp 文件中是有逻辑动机的：

1. 既然可以有一个文件，为什么还要有两个文件呢？
2. 复制声明/函数头是不必要的维护并且感觉多余。我们有代码分析工具来展示接口。
3. 内联/模板代码必须放在标头中而其他代码放在 .cpp 中的概念是任意的。如果我们被迫将内联代码放入 .hpp 文件中，并且这没问题，那么为什么不将所有代码放入 .hpp 文件中呢？

不过，我非常确定单独的 .cpp 和 .hpp 文件的传统比推理要强大得多。