c++如何使用Cereal库进行序列化_c++现代化的序列化库【教程】

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

使用 Cereal 库进行 C++ 序列化，核心就三步：引入头文件、定义序列化函数、选择存档类型（JSON / Binary / XML）来读写。它轻量、头文件仅依赖、无需预编译或 IDL，是现代 C++ 项目中非常自然的序列化方案。

1. 快速接入 Cereal

Cereal 是纯头文件库，直接下载 cereal/include/cereal 目录，加到项目 include 路径即可。CMake 中可这样引入：

include_directories(${CMAKE_SOURCE_DIR}/third_party/cereal/include)

无需链接任何库，也不需要生成代码 —— 它靠 C++ 模板和 ADL（参数依赖查找）自动发现序列化逻辑。

2. 为自定义类添加序列化支持

最常用方式是在类内部或外部定义 serialize 成员函数或非成员函数，签名固定为：template void serialize(Archive& ar)。

例如：

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 或放在同命名空间）：

template
void 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(this))。

基本上就这些。Cereal 不复杂但容易忽略细节：比如忘记加 template、误用 const 导致无法写入、或 JSON 读取前没检查文件是否存在。用熟之后，它比 Boost.Serialization 更清爽，比手写 JSON 解析更安全。

# js # json # 字节 # c++ # stream # 配置文件 # red # 命名空间 # 成员函数 # 析构函数 # include # xml # const # void # 指针 # 继承 # class # map # this # ar # 序列化 # 头文件 # 三步 # 中非 # 字段名 # 也不 # 是在 # 放在 # 并在 # 三种

返回目录在线咨询

上一篇：广告制作行业网站有哪些,如何制作一个广告网站？
下一篇：在Ubuntu中安装Docker教程

您的项目需求