減少 C++ 編譯時間的三大核心策略：前向聲明、Pimpl、扁平化繼承

痛點：大型項目編譯時間是生產力殺手

頭文件變動 → 所有引用者強制重編。Chrome 級項目一次全量編譯可耗時數小時。掌握編譯依賴最小化技巧，是資深工程師必備技能。

策略一：消除不必要的 #include，改用前向聲明

判斷原則

• **僅作指針/引用類型、函數參數/返回值** → 前向聲明即可
• **作為基類、成員對象、模板實參、需要知道 sizeof/佈局** → 必須 #include

實戰重構示例

// 原始 old.h - 5 個 #include
#include "file.h"   // 基類，必須保留
#include "db.h"     // 基類，必須保留
#include "cx.h"     // 成員類型，必須保留
#include "deduce.h" // 成員類型，必須保留
#include "error.h"  // 僅作參數/返回值 → 可前向聲明

// 優化後
#include "file.h"
#include "db.h"
#include "cx.h"
#include "deduce.h"
class error;  // 前向聲明

// 標準庫優化
#include   // 替代 /，僅含流類型前向聲明
// 內部實現用  時再在 .cpp 中包含

策略二：Pimpl 惯用法 — 隱藏私有實現細節

核心思想

將**所有私有成員**移至不透明的實現類，頭文件僅保留一個指針：

// old.h
class Old {
public:
    Old(const Cx&);
    // ... 公有介面 ...
private:
    class Impl;          // 前向聲明
    Impl* pImpl;         // 唯一私有成員
};

// old.cpp
struct Old::Impl {
    std::list cxList;
    Deduce deduce;
    // 所有私有細節在此，任意變更不影響客戶端編譯
};

Old::Old(const Cx& c) : pImpl(new Impl) {}
Old::~Old() { delete pImpl; }  // 需在 .cpp 定義析構函數

優缺點權衡

策略三：剔除不必要的繼承，改用組合

反模式識別

class Old : public File, private Db {  // 私有繼承 Db 是何意圖？
    // ...
};

私有繼承通常為「is-implemented-in-terms-of」，**組合更清晰、編譯依賴更弱**。

重構後

// old.h
#include "file.h"  // 公有繼承保留 (有虛函數需 override)
class Db;          // 前向聲明
class Cx;
class Error;

class Old : public File {
public:
    Old(const Cx&);
    Db getDb(int, char*);
    // ...
private:
    class Impl;
    Impl* pImpl;
};

// old.cpp
struct Old::Impl {
    Db db;                 // 組合替代私有繼承
    std::list cxList;
    Deduce deduce;
};

綜合效果對比

工程落地建議

1. **新代碼強制 Pimpl**：所有類默認隱藏私有實現
2. **頭文件極簡原則**：只包含必要基類與成員類型定義
3. **統一使用 iosfwd、memory 等前向聲明頭**
4. **避免保護成員變量**：破壞封裝，增加編譯耦合
5. **大型項目引入編譯緩存 (ccache/sccache) + 分佈式編譯 (distcc/Incredibuild)**