#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();    // 一起分享玩具 ??
    }
};