头文件循环引用：如何破解这个编程死循环？

#include <iostream>     // 借本输入输出的魔法书 ✨
#include <string>       // 再来本字符串变变变 🎭
#include <vector>       // 这本是动态数组的秘籍 📦
#include <algorithm>    // 最后来本算法宝典 🔮

#include "MyClass.h"           // 就在书桌上的笔记本 📓
#include "utils/helpers.h"     // 放在工具箱里的说明书 🛠️
#include "../common/config.h"  // 楼上收藏的配置手册 📋

# GCC编译器 🛠️
g++ -v -E -x c++ /dev/null

# Clang编译器 🔧
clang++ -v -E -x c++ /dev/null

# 在 Linux/Unix 系统中通常是: 🐧
/usr/include/c++/<版本号>      # C++标准库头文件 📘
/usr/local/include            # 本地安装的库文件 📗
/usr/include                  # 系统级别的头文件 📙

# 在 Windows + MSVC 中通常是: 🪟
C:\Program Files (x86)\Microsoft Visual Studio\<版本>\<版本号>\VC\include

#include <iostream>

// 1. 编译器首先在内置缓存中找iostream
// 2. 如果没找到，则在/usr/include/c++/<版本号>/iostream查找
// 3. 找到后，检查是否已经被包含（通过头文件保护符）
// 4. 如果是首次包含，则读取并处理文件内容

# 在Linux系统中可以直接查看
cat /usr/include/c++/<版本号>/iostream

# 或者使用编译器显示预处理后的内容
g++ -E myfile.cpp | less

// 如果源文件在 src/main.cpp
#include "myproject.h"  // 会先查找 src/myproject.h 🔎

// 在 src/main.cpp 中
#include "../include/myproject.h"  // 查找上级目录的 include 文件夹 📁

// main.cpp 📄
#include <iostream>
#include "utils/math_helper.h"

int main() {
    // ...
}

// 1. 在标准库路径找到 iostream 📚
// 2. 检查是否已经包含（通过头文件保护符）🛡️
// 3. 展开内容，例如：✨
namespace std {
    class ios_base { /*...*/ };  // 基础输入输出类 🔧
    class istream { /*...*/ };   // 输入流类 📥
    // ...
}

// 1. 先在当前目录查找 utils/math_helper.h 🔎
// 2. 如果找不到，继续在编译器指定的路径查找 🗂️
// 3. 展开内容 📖

project/ 📁 ├── include/ # 公共头文件目录 📚 │ ├── project/ # 项目头文件 📋 │ │ ├── core.h # 核心头文件 ⚡ │ │ └── utils.h # 工具头文件 🛠️ │ └── third_party/ # 第三方库头文件 🔌 ├── src/ # 源文件目录 💻 │ ├── core.cpp # 核心实现 ⚙️ │ └── utils.cpp # 工具实现 🔧 └── CMakeLists.txt # CMake 构建文件 🏗️

// 在 src/core.cpp 中 📝
#include "project/core.h"    // 使用项目头文件 🏠
#include <algorithm>         // 使用标准库 📚

// 文件：header1.h
#include "header2.h"
class PersonA {
private:
    PersonB* m_friend;  // 想和 PersonB 做朋友 🤝
public:
    void sayHello();
};

// 文件：header2.h
#include "header1.h"
class PersonB {
private:
    PersonA* m_friend;  // 也想和 PersonA 做朋友 🤝
public:
    void greet();
};

// 文件：header1.h
#ifndef HEADER1_H
#define HEADER1_H

class PersonB;  // 先说好：PersonB 待会儿就来！✨
class PersonA {
    // ... 其他代码保持不变 ...
};

#endif

// 文件：header1.h
#include "header2.h"
class PersonA {
private:
    PersonB m_friend;  // 想直接把朋友装进口袋！😮
public:
    void sayHello();
};

// 文件：header2.h
#include "header1.h"
class PersonB {
private:
    PersonA m_friend;  // 我也要把朋友装进口袋！
public:
    void greet();
};

// 先设计一张可爱的交友名片 💌
class IFriend {
    virtual void sayHi() = 0;     // 我会说"嗨！" 👋
    virtual void share() = 0;     // 我会分享玩具！ 🎮
    virtual ~IFriend() = default; // 记得要好好说再见 👋
};

// 小明拿着这张名片来交朋友 👦
class XiaoMing : public IFriend {
    void sayHi() override { 
        std::cout << "嗨，我是小明！" << std::endl; 
    }
    void share() override {
        std::cout << "给你我的变形金刚！" << std::endl;
    }
};

// 小红也想交朋友 👧
class XiaoHong {
private:
    IFriend& myFriend;  // 只需要知道对方有张交友名片就够啦！
public:
    void playWith() {
        myFriend.sayHi();    // 和朋友打招呼 🤝
        myFriend.share();    // 一起分享玩具 🎈
    }
};