C++ 類相互包含與前向聲明：解決 A 包含 B 對象、B 持有 A 指針的循環依賴

經典難題：類 A 以**值**成員持有 B，類 B 以**指針**持有 A。直接包含頭文件會導致遞歸定義編譯錯誤。解決鍵在於：**前向聲明 + 指針/引用成員 + 實現文件中包含完整定義**。

最小可編譯示例

// A.h
class B;                    // 前向聲明
class A {
    B* b_ptr;               // 指針/引用不需要完整定義
public:
    void setB(B* b) { b_ptr = b; }
    void callB();
};

// B.h
class A;                    // 前向聲明
class B {
    A* a_ptr;
public:
    void setA(A* a) { a_ptr = a; }
    void callA();
};

// A.cpp
#include "A.h"
#include "B.h"              // 此處需要 B 完整定義
void A::callB() { if (b_ptr) b_ptr->callA(); }

// B.cpp
#include "B.h"
#include "A.h"              // 此處需要 A 完整定義
void B::callA() { if (a_ptr) a_ptr->callB(); }

// main.cpp
#include "A.h"
#include "B.h"
int main() {
    A a; B b;
    a.setB(&b); b.setA(&a);
    a.callB();              // 相互調用
}

核心規則

1. 頭文件中： 僅用前向聲明 class B;，成員只能是 **指針/引用** (B*/B&)，**不可為值類型** (B b; 需完整定義知大小)
2. .cpp 實現文件中： 包含對方頭文件獲取完整定義，實現成員函數
3. 構造/析構函數： 若涉及對方成員操作，必須放在 .cpp 中定義 (頭文件內聯會報錯)

MFC 實戰場景

CTestDlg (對話框類) 持有 A 對象，A 需回調 CTestDlg 方法。
步驟：

1. A.h 前向聲明 class CTestDlg;，成員 CTestDlg* m_pDlg;
2. A.cpp 包含 "TestDlg.h" 實現回調
3. CTestDlg.h 包含 "A.h"，成員 A m_a; (值類型，需完整定義)
4. CTestDlg.cpp 構造時 m_a.setDlg(this);
5. 包含順序關鍵： Test.h → A.h → TestDlg.h (避免循環包含)

現代 C++ 替代方案

• std::unique_ptr / std::shared_ptr 管理生命週期，同樣只需前向聲明
• 介面類 (純虛類) 解耦：A 持有 IB*，B 繼承 IB
• 觀察者模式 / 信號槽 (Qt/Boost.Signals2) 彻底消除雙向持有