有一天，c++程序员们就《路》达成一致，羊羔将和狮子躺在一起，巴勒斯坦人将拥抱以色列人，猫和狗将被允许结婚。

在这一点上，.h和.cpp文件之间的分离基本上是任意的，这是编译器优化很久以前的遗留问题。在我看来，声明属于头文件，定义属于实现文件。但是，那只是习惯，不是宗教。

我把所有实现都放在类定义之外。我想把doxygen注释从类定义中删除。

我认为你的同事很聪明，你也是对的。

我发现把所有东西都放在头文件中的有用的事情是:

不需要写和同步头文件和源文件。 结构很简单，没有循环依赖迫使编码器做出“更好”的结构。 便携，易于嵌入到新项目中。

我同意编译时间的问题，但我认为我们应该注意到:

源文件的改变很可能会改变头文件，从而导致整个项目重新编译。 编译速度比以前快多了。而如果你的项目建设时间长、频率高，这可能说明你的项目设计存在缺陷。将任务分离到不同的项目和模块中可以避免这个问题。

最后，我只是想支持你的同事，只是在我个人看来。

你的同事错了，通常的方法是把代码放在。cpp文件(或任何你喜欢的扩展名)中，并在头文件中声明。

将代码放在头文件中偶尔会有一些好处，这可以让编译器更聪明地进行内联。但与此同时，它会破坏编译时间，因为所有代码在每次被编译器包含时都必须被处理。

最后，当所有的代码都是头部时，循环对象关系(有时是需要的)通常是令人讨厌的。

总之，你是对的，他是错的。

编辑:我一直在思考你的问题。在一种情况下，他说的是真的。模板。许多较新的“现代”库，如boost，大量使用模板，通常是“头文件”。但是，只有在处理模板时才应该这样做，因为这是处理模板时的唯一方法。

编辑:有些人想要更多的澄清，这里有一些关于写“只有头”代码的缺点的想法:

If you search around, you will see quite a lot of people trying to find a way to reduce compile times when dealing with boost. For example: How to reduce compilation times with Boost Asio, which is seeing a 14s compile of a single 1K file with boost included. 14s may not seem to be "exploding", but it is certainly a lot longer than typical and can add up quite quickly when dealing with a large project. Header only libraries do affect compile times in a quite measurable way. We just tolerate it because boost is so useful.

此外，还有许多事情不能仅在头文件中完成(甚至boost也有一些库，您需要链接到某些部分，如线程、文件系统等)。一个主要的例子是你不能在只有头的库中有简单的全局对象(除非你求助于讨厌的单例)，因为你会遇到多个定义错误。注意:c++ 17的内联变量将使这个特殊的例子在未来可行。

最后一点，当使用boost作为仅头代码的示例时，经常会忽略一个巨大的细节。

Boost是库，而不是用户级代码。所以它不会经常变化。在用户代码中，如果你把所有东西都放在头文件中，每一个小的改变都会导致你不得不重新编译整个项目。这是对时间的巨大浪费(对于那些在不同的编译器之间不进行更改的库来说，情况并非如此)。当你在头文件/源文件之间拆分时，更好的是，使用前向声明来减少包含，你可以在一天内节省数小时的重新编译时间。

我个人在头文件中这样做:

// class-declaration

// inline-method-declarations

我不喜欢将方法的代码与类混合在一起，因为我发现快速查找东西很痛苦。

我不会把所有的方法都放在头文件中。编译器(通常)不能内联虚拟方法，(可能)只内联没有循环的小方法(完全取决于编译器)。

在类中执行方法是有效的…但从可读性的角度来看，我不喜欢它。将方法放在头文件中确实意味着，如果可能的话，它们将被内联。

模板代码应该只在头文件中。除此之外，除了内联之外的所有定义都应该在.cpp中。最好的参数是遵循相同规则的std库实现。你不会不同意std lib开发人员在这方面是正确的。