C++中头文件设计

Posted 2022-11-09

对于小工具程序而言，用C++编写估计也就几个文件，此时很少设计头文件互相包含引发的编译出错问题。
但是当软件功能越来越多，功能越来越复杂，各模块之间的调用关系也越来越不明显，此时很有可能会出现A头文件包含B头文件，B头文件包含A头文件的情况，这种互相包含头文件会导致出现找不到编译类型的错误。
最简单的代码如下：
A.h如下

#include "B.h"
class A

    B b;

A.cpp如下

#include "A.h"
class A

     ...

B.h如下

#include "A.h"
class B

  A a;

B.cpp如下

#include "B.h"
class B

...

如果文件是上述这种情况，则编译出现找不到类型，因为头文件中A包含了B头文件，B中又包含了A头文件，这种循环包含会导致编译出错。

解决办法
解决办法采用前置声明。
改后代码如下
A.h如下

class B;
class A

    B b;

A.cpp如下

#include "A.h"
#include "B.h"
class A

     ...

B.h如下

class A
class B

  A a;

B.cpp如下

#include "B.h"
#include "A.h"
class B

...

如果想一劳永逸呢？
对于经常用到的模块的头文件，可以统一写一份前置声明文件，将常用的声明都写入这个头文件，比如叫做includeDeclare.h,然后将其实际的头文件都放入一个文件，比如includeHeaders.h中。这样后续其他地方使用的时候，只要在头文件中引入includeDeclare.h，在实现cpp文件中引入includeHeaders.h。