如何修复C++头文件循环依赖导致的基类未定义编译错误

报错原因 #

1. 继承场景需要基类的完整定义，前向声明不生效：C++中当你用某个类作为基类、定义类的成员实例、或者直接调用类方法的时候，必须要让编译器看到该类的完整定义，仅靠前向声明只能用来声明指针、引用、函数参数/返回值类型，无法满足继承的语法要求。
2. 头文件的包含顺序错误，导致Foo定义晚于Bar的继承声明：你在foo.h的开头就包含了bar.h和baz.h，而类Foo的定义放在了两个include语句之后。我们可以模拟编译过程（假设编译单元先引入foo.h）：
   • 编译器开始处理foo.h，标记foo.h已包含，先执行#include "baz.h"
   • 处理完baz.h回到foo.h，接下来执行#include "bar.h"
   • 处理bar.h时，因为foo.h已经标记为已包含，所以bar.h开头的#include "foo.h"直接跳过
   • 此时bar.h里的class Bar : public Foo语句触发编译：Foo的完整定义还没出现（还在处理foo.h的include阶段，Foo的定义写在include语句之后），只有你写的前向声明class Foo，自然就报基类未定义的错误。
3. 多余的include引入了不必要的循环依赖：你的代码里foo.h和baz.h的include完全是多余的——如果Foo、Baz的类定义里没有用到其他类的实例，只需要前向声明即可，不需要引入头文件，反而形成循环。

修复方案 #

核心思路是只在必要的时候引入头文件，非必要场景用前向声明替代：

1. bar.h因为要继承Foo，必须保留#include "foo.h"，其他不需要的include全部删掉。
2. foo.h、baz.h里不需要的include全部删掉，仅保留必要的前向声明即可。

修复后的代码如下：

baz.h #

#pragma once
class Foo;
class Bar;

class Baz
{
    // 如果Baz里用到Foo/Bar的指针/引用，前向声明足够，不需要include
};

bar.h #

#pragma once
#include "foo.h" // 因为继承Foo，必须保留

class Baz; // 如果用到Baz的指针/引用保留，否则可以删掉

class Bar : public Foo
{
};

foo.h #

#pragma once
class Baz;
class Bar;

class Foo
{
    // 如果Foo里用到Baz/Bar的指针/引用，前向声明足够，不需要include
};

如果后续你的Foo或者Baz类里需要用到其他类的实例（不是指针/引用），或者要调用其他类的方法，再把对应头文件加到cpp文件里，或者头文件的类定义之后即可，避免提前引入造成循环。

内容的提问来源于stack exchange，提问作者JensB