C++ 序列化方案深度對比：Protobuf vs Boost.Serialization 實戰心得

什麼是序列化？

將物件在記憶體中的狀態轉換為可儲存、可傳輸的位元組流（或文本流）的過程。逆過程為反序列化。核心用途：

1. 持久化：物件存檔，下次啟動快速載入，避免重複昂貴計算。
2. 網路傳輸：跨進程、跨機器、跨語言傳遞結構化資料。

C++ 四大序列化方案概覽

Protobuf 實戰避坑指南

1. 支援的資料型別對照表（必收藏）

2. 兩大硬傷

• 不支援 STL 容器：無 vector<vector<int>>、map、set 等。需手動展平或用 repeated 模擬一維陣列。
• 巢狀類型會改名：message A { message B {} } 生成的類為 A_B 而非 B。解決：將巢狀類提到頂層定義。

Boost.Serialization 實戰避坑指南

1. 安裝踩坑全記錄（Ubuntu 為例）

# 必裝依賴
sudo apt-get install libbz2-dev zlib1g-dev libpython3-dev

# 源碼安裝
./bootstrap.sh
./b2 -j$(nproc) --with-serialization --with-system --with-filesystem
sudo ./b2 install

常見錯誤：

• pyconfig.h not found → 裝 python3-dev。
• bzlib.h not found → 裝 libbz2-dev。

2. 連結庫選擇

• -lboost_serialization：窄字符（char）。
• -lboost_wserialization：寬字符（wchar_t）。

3. 非侵入式序列化的條件

類別成員必須 public，或在類內聲明：

class MyClass {
    friend class boost::serialization::access;
    template<class Archive>
    void serialize(Archive & ar, unsigned version) {
        ar & member1 & member2;
    }
private:
    int member1; string member2;
};

4. 指標與陣列陷阱

• 基本型別指標（int*）無法直接序列化：需包裝成結構體。
• 動態陣列 new T[n] 不能直接序列化：需用 std::vector 或固定大小陣列 T arr[N]。
• 物件陣列指標 new A[n] 會被當成單一物件：只序列化第一個元素。必須用 A arr[N] 或 vector<A>。

選型決策樹

需要跨語言 / 極致效能 / 結構固定？ → Protobuf
需要 STL 容器 / 複雜物件圖 / 不想改既有代碼 / 純 C++？ → Boost.Serialization
Windows 老專案 / MFC 體系？ → MFC
.NET 生態？ → .NET BinaryFormatter / JSON.NET

總結

Protobuf 輕量、快、跨語言，適合「定義一次，到處用」的服務介面。Boost.Serialization 重裝備、功能全、非侵入，適合「既有複雜 C++ 物件模型持久化」的場景。兩者互補，而非替代。根據專案實際約束選擇，切勿盲目跟風。