C++怎么使用cereal库进行序列化_C++现代化的头文件式对象序列化库_技术教程

C++中使用cereal库可便捷实现对象序列化，该头文件库支持JSON、XML和二进制格式。1. 无需安装，直接包含头文件即可使用；2. 通过定义serialize函数模板并配合CEREAL_NVP宏实现成员变量的序列化；3. 利用输出归档（如JSONOutputArchive）将对象保存至文件；4. 使用输入归档（如JSONInputArchive）从文件反序列化恢复对象；5. 原生支持vector、map等STL容器，私有成员可通过友元和宏处理。整个过程简洁直观，适合现代C++项目快速集成。

C++中使用cereal库进行序列化非常方便，它是一个现代化、轻量级、仅头文件的C++序列化库，支持将对象保存为JSON、XML、二进制等格式。由于是头文件形式，无需编译安装，只需包含相应头文件即可使用。

1. 安装与引入cereal

cereal是纯头文件库，可以直接从GitHub下载并放入项目include目录：

访问 https://github.com/USCiLab/cereal 下载源码
将include/cereal目录复制到你的项目中
在代码中包含所需头文件，例如：

#include json.hpp>
#include
#include

2. 基本序列化操作

要让一个类支持序列化，需在其内部或外部定义serialize函数模板，声明其如何读写成员变量。

示例：序列化一个简单的Person类

class Person {
public:
    std::string name;
    int age;

    // 序列化函数
    template
    void serialize(Archive& ar) {
        ar(CEREAL_NVP(name), CEREAL_NVP(age)); // NVP添加命名信息（用于JSON/XML）
    }
};

然后可以将其保存为JSON文件：

#include 
#include 

void save() {
    Person p{"Alice", 30};

    std::ofstream os("person.json");
    cereal::JSONOutputArchive archive(os);
    archive(CEREAL_NVP(p));
}

3. 反序列化还原对象

反序列化过程与序列化类似，只需创建输入归档对象并从中加载数据。

void load() {
    Person p;

    std::ifstream is("person.json");
    cereal::JSONInputArchive archive(is);
    archive(p); // 或 archive(CEREAL_NVP(p));

    std::cout << "Name: " << p.name << ", Age: " << p.age << std::endl;
}

4. 支持其他容器和类型

cereal天然支持STL常见类型，如vector、map、string、array等，无需额外定义。

例如序列化一个学生列表：

std::vector students = {{"Bob", 25}, {"Charlie", 28}};

{
    std::ofstream os("students.json");
    cereal::JSONOutputArchive ar(os);
    ar(CEREAL_NVP(students));
}

读取时也一样直接：

std::vector loaded_students;
std::ifstream is("students.json");
cereal::JSONInputArchive ar(is);
ar(loaded_students);

基本上就这些。只要包含对应头文件，实现serialize方法，就能轻松完成对象持久化。不复杂但容易忽略的是确保每个成员都被正确注册到归档中。对于私有成员，可使用CEREAL_SERIALIZE_FUNCTION_NAME宏配合友元方式处理。cereal的设计简洁直观，适合现代C++项目快速集成序列化功能。