不能直接用std::ofstream::write(&obj, sizeof(obj))序列化c++对象,因为非pod类型(如std::string、虚函数、继承)的sizeof仅含栈布局,不含堆数据,且指针地址、内存对齐、abi差异导致跨平台/反序列化失败。

直接用 std::ofstream::write(reinterpret_cast<const char>(&obj), sizeof(obj))</const> 会崩溃或读出乱码,这不是“写不进去”,而是把指针地址、虚表偏移、std::string 内部缓冲区地址一起存了——反序列化时这些地址早已失效。
为什么不能直接 write(sizeof(obj))
因为 C++ 对象不是内存块的简单镜像。哪怕你定义的是 struct,只要含 std::string、std::vector、虚函数、继承关系或任何非 POD 成员,sizeof 就只给出栈上布局大小,不包含堆上实际数据。
-
std::string name在对象里只存一个指针(通常 8 字节),write只保存这个指针值,不是字符串内容本身 - 反序列化后,该指针指向已释放或未分配的内存,
name.c_str()触发段错误 - 不同编译器、不同 ABI(如 MSVC vs GCC)、不同优化等级下,内存对齐和 padding 可能不同,二进制文件无法跨平台/跨构建复用
手动实现 serialize/deserialize 成员函数
适合轻量、可控、无第三方依赖的场景,比如游戏存档、本地配置、嵌入式设备状态快照。核心是逐字段处理,显式控制字节流结构。
- 对
std::string:先写长度size_t,再写字符数据;读时先读长度,resize后read到&str[0] - 对
std::vector<t></t>:同样先写size(),再循环写每个T(若T本身可序列化) - 注意字节序:如需跨平台,
htonl/ntohl转换整数,避免小端机器写、大端机器读出错 - 不要用
reinterpret_cast<char>(&member)</char>直接读写浮点数(如float),IEEE 754 格式虽通用,但某些旧平台或嵌入式芯片可能不兼容;稳妥做法是转为整数位表示再存
示例片段:
void serialize(std::ostream& out) const {
uint32_t len = static_cast<uint32_t>(name.size());
out.write(reinterpret_cast<const char>(&len), sizeof(len));
out.write(name.data(), len);
out.write(reinterpret_cast<const char>(&age), sizeof(age));
}</const></const></uint32_t>
用 nlohmann/json 实现 to_json/from_json
当目标是配置文件、调试日志、Web API 交互或需要人工可读时,JSON 是最安全、最省心的选择。nlohmann/json 支持头文件直用,C++17 起还能配合结构化绑定简化代码。
- 必须用
NLOHMANN_DEFINE_TYPE_INTRUSIVE或NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE声明映射关系,否则库不知道怎么把字段塞进 JSON object -
std::chrono::system_clock::time_point、std::optional<t></t>、std::variant等类型需额外提供to_json/from_json特化,否则编译失败 - 不支持裸指针、
std::function、虚基类 —— 这其实是好事,逼你把业务逻辑和序列化解耦 - 生成的 JSON 文件体积比二进制大 3–5 倍,但可 diff、可 patch、可 grep,开发阶段效率远高于调试二进制格式
声明方式示例:
NLOHMANN_DEFINE_TYPE_INTRUSIVE(Person, name, age)
Boost.Serialization 是唯一能处理多态和指针共享的方案
如果你的类有虚函数、继承链、std::shared_ptr<base> 指向派生类对象,或多个对象共享同一份数据(如图结构中的节点引用),只有 Boost.Serialization 能正确还原语义。
- 必须加
friend class boost::serialization::access;,否则私有成员不可访问 - 归档类型选
boost::archive::binary_oarchive(紧凑)还是text_oarchive(可读),取决于是否要人工检查中间文件 - 链接时要加
-lboost_serialization,且确保所有被序列化的类型(包括 STL 容器元素)都支持该库的序列化协议 - 版本号参数
version不是摆设:后续加字段、删字段、改类型时,靠它做兼容性分支,否则老文件读新程序直接抛异常
最容易被忽略的一点:Boost 的 archive 对象生命周期必须长于序列化调用。下面这段代码是错的:
void save_bad() {
std::ofstream ofs("x.dat");
boost::archive::binary_oarchive oa(ofs); // oa 构造时绑定了 ofs
oa
<p>正确做法是让 <code>oa</code> 自然离开作用域析构,或显式调用 <code>oa.flush()</code>。</p>C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











