不能直接用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>：同样先写size()，再循环写每个T（若T本身可序列化） - 注意字节序：如需跨平台，
htonl/ntohl转换整数，避免小端机器写、大端机器读出错 - 不要用
reinterpret_cast<char*>(&member)直接读写浮点数（如float），IEEE 754 格式虽通用，但某些旧平台或嵌入式芯片可能不兼容；稳妥做法是转为整数位表示再存
示例片段：
立即学习“C++免费学习笔记（深入）”；
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));
}
用 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>、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 << obj;
ofs.close(); // 错！oa 还没析构，内部缓冲可能未刷盘
}
正确做法是让 oa 自然离开作用域析构，或显式调用 oa.flush()。
