Cereal序列化核心三步:引入头文件、定义serialize函数、选JSON/Binary/XML存档;它轻量纯头文件、无需预编译,支持容器/智能指针/版本控制/继承。

使用 Cereal 库进行 C++ 序列化,核心就三步:引入头文件、定义序列化函数、选择存档类型(JSON / Binary / XML)来读写。它轻量、头文件仅依赖、无需预编译或 IDL,是现代 C++ 项目中非常自然的序列化方案。
1. 快速接入 Cereal
Cereal 是纯头文件库,直接下载 red">cereal/include/cereal 目录,加到项目 include 路径即可。CMake 中可这样引入:
include_directories(${CMAKE_SOURCE_DIR}/third_party/cereal/include)
无需链接任何库,也不需要生成代码 —— 它靠 C++ 模板和 ADL(参数依赖查找)自动发现序列化逻辑。
2. 为自定义类添加序列化支持
最常用方式是在类内部或外部定义 serialize 成员函数或非成员函数,签名固定为:template。
立即学习“C++免费学习笔记(深入)”;
例如:
struct Person {
std::string name;
int age = 0;
template
void serialize(Archive& ar) {
ar(CEREAL_NVP(name), CEREAL_NVP(age));
}
};
CEREAL_NVP 是“命名变量包装器”,用于 JSON/XML 输出时保留字段名;二进制存档中可省略,直接写 ar(name, age) 也行。
若不想改类定义,也可用外部非成员函数(需声明为 friend 或放在同命名空间):
templatevoid serialize(Archive& ar, Person& p) { ar(CEREAL_NVP(p.name), CEREAL_NVP(p.age)); }
3. 选择存档类型并读写数据
Cereal 提供三种主流存档:
- BinaryArchive:最快、体积最小,跨平台但不兼容不同字节序(通常本地用没问题)
- JSONArchive:人类可读、跨语言友好,支持嵌套、注释(需开启宏),默认带字段名
- XMLOutputArchive / XMLInputArchive:结构清晰,适合配置文件场景,但较冗余
写入示例(JSON):
std::ofstream os("person.json");
cereal::JSONOutputArchive ar(os);
ar(CEREAL_NVP(p)); // p 是 Person 实例
读取示例(自动推导类型):
std::ifstream is("person.json");
cereal::JSONInputArchive ar(is);
Person p2;
ar(CEREAL_NVP(p2));
4. 处理常见情况的小技巧
• 容器与智能指针:std::vector、std::map、std::unique_ptr 等开箱即用,无需额外定义(只要元素类型可序列化)。
• 版本控制:用 CEREAL_CLASS_VERSION(MyClass, 2) 声明版本,在 serialize 中用 ar(cereal::make_nvp("field", field)) + 条件逻辑做兼容。
• 忽略字段:用 cereal::make_nvp("ignored", cereal::binary_data(...)) 或更推荐——在 serialize 中跳过该字段(只读/写时条件判断)。
• 继承支持:基类需有虚析构函数,并在 serialize 中显式调用 ar(cereal::base_class。
基本上就这些。Cereal 不复杂但容易忽略细节:比如忘记加 template、误用 const 导致无法写入、或 JSON 读取前没检查文件是否存在。用熟之后,它比 Boost.Serialization 更清爽,比手写 JSON 解析更安全。











