C++两个头文件互相#include报错 已加#pragma once仍无法解决怎么办

问题根因 #

#pragma once 仅能避免同一头文件被重复展开，无法解决循环依赖导致的类型定义顺序死锁：
当你在Y.h中添加#include "X.h"后，编译器展开逻辑为：

1. 任意cpp引入X.h时，先标记X.h已加载，然后执行X.h中的#include "y.h"
2. 标记Y.h已加载，执行Y.h中的#include "x.h"，此时X.h已标记加载不会重复展开
3. Y.h后续代码如果用到X类型，会因为X还没完成定义直接报错
   如果移除#pragma once，两个头文件会无限递归互相包含，直接触发包含深度超限错误。

通用解决方案 #

方案1：前置声明（优先使用，90%场景可解决） #

如果Y.h中仅用到X类型的指针、引用，或仅将X作为函数参数/返回值类型，不需要知道X的内存布局、不需要调用X类成员，则不需要引入X.h，仅需在Y.h中添加X的前置声明即可：
Y.h修改后代码：

#pragma once
using namespace std;
// 替换#include "X.h"，添加前置声明
class X;
class Y{
    // 此处可正常使用X*、X&、参数/返回值为X的函数声明
};

该方案下原有X.h无需修改，循环依赖直接被打破。

注意：如果Y需要继承X、Y类包含X的实例成员、或Y头文件中需要调用X的成员方法，则无法使用前置声明，必须采用方案2拆分实现。

方案2：头文件声明与cpp实现拆分 #

如果必须用到对方类的完整定义，按以下步骤修改：

• 两个头文件都移除对方的#include语句，仅保留需要的类型前置声明
• 所有需要用到对方类成员的逻辑，全部移动到对应的.cpp文件中实现，在.cpp文件中再引入两个头文件即可

现有代码的额外优化点 #

你当前X.h中定义的static unique_ptr<Y> y[5][5];属于头文件全局静态变量，每个引入X.h的cpp文件都会生成独立的y数组实例，大概率不符合预期，建议修改为：

1. X.h中改为extern unique_ptr<Y> y[5][5];
2. 在对应的X.cpp中添加unique_ptr<Y> y[5][5];的定义

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