C++ 句柄類模式：利用前向宣告減少編譯依賴與重新編譯

當頭文件修改時，所有包含它的原始檔都需重新編譯——這是著名的「易碎基類問題」。對於大型專案，編譯時間極其可觀。句柄類模式配合前向宣告，能將實作細節隱藏於 .cpp 中，大幅減少不必要的重新編譯。

問題示範：修改 A 導致 main.cpp 重編

// head.h
struct A { int i; };  // 完整定義

class B {  // 句柄類，包裝 A
    A* a;
public:
    B(int n = 0);
    void show();
    ~B();
};

// head.cpp
#include "head.h"
#include <iostream.h>
B::B(int n) { a = new A; a->i = n; }
void B::show() { cout << a->i; }
B::~B() { delete a; }

// main.cpp
#include <iostream>
#include "head.h"
int main() { B b(1); b.show(); return 1; }

若修改 struct A (如新增欄位)，head.h 變更 → head.cpp、main.cpp 皆需重編，即使 main.cpp 完全不關心 A 的內部結構。

解決方案：前向宣告 + 定義下沉

// head.h (修改後)
class B {
    struct A;  // 前向宣告：不完整型別，僅宣告存在性
    A* a;      // 指標/引用只需不完整型別
public:
    B(int n = 0);
    void show();
    ~B();
};

// head.cpp (修改後)
#include "head.h"
#include <iostream.h>

struct B::A {  // 完整定義移至 .cpp，屬於 B 的巢狀類別
    int i;
    // 新增欄位僅影響 head.cpp
};

B::B(int n) { a = new A; a->i = n; }
void B::show() { cout << a->i; }
B::~B() { delete a; }

// main.cpp (完全不變)
#include <iostream>
#include "head.h"
int main() { B b(1); b.show(); return 1; }

核心原理解析

句柄類 B 僅持有 A*，頭文件只需 struct A; 前向宣告。完整定義下沉至 head.cpp，成為 B 的私有巢狀類別 B::A，實現介面與實作完全分離。

效益量化

• 修改 A 定義：僅觸發 head.cpp 重編，main.cpp 及其他使用 B 的檔案零影響
• 大型專案：若 100 個檔案包含此頭文件，節省 99 個檔案的編譯時間
• 封裝性提升：A 的實作細節完全隱藏，使用者無法直接存取 A 成員

進階形式：Pimpl 慣用語

更通用的做法是 Pimpl (Pointer to Implementation)：

// Widget.h
class Widget {
    struct Impl;  // 前向宣告
    std::unique_ptr<Impl> pImpl;  // 智慧指標管理生命週期
public:
    Widget();
    ~Widget();  // 必須在 .cpp 定義，因需完整 Impl 型別
    void doSomething();
};

// Widget.cpp
struct Widget::Impl {
    int data1, data2;
    std::vector<string> items;
    // 任意複雜實作細節
};
Widget::Widget() : pImpl(std::make_unique<Impl>()) {}
Widget::~Widget() = default;
void Widget::doSomething() { pImpl->data1++; }

Pimpl 是現代 C++ 實現編譯防火牆的標準模式，廣泛用於 Qt、標準庫實現等大型專案。

適用性判斷

• ✅ 類別頻繁變更實作細節
• ✅ 大型專案、編譯時間敏感
• ✅ 需隱藏第三方庫依賴 (如 Windows.h、OpenSSL 結構體)
• ❌ 簡單、穩定、輕量級類別 (增加間接層開銷)
• ❌ 需高效能、內存佈局敏感場景 (指標間接存取有微小開銷)

掌握前向宣告與 Pimpl，能從架構層面優化建構系統，是資深 C++ 開發者的必備技能。