直接写sizeof结构体必然失败，因其网状结构（含指针、智能指针、虚函数表等）内存不连续，sizeof仅返回头大小，堆内存未被写入，导致野指针、段错误或数据为空。
为什么 std::ofstream 直接写 sizeof 结构体必然失败
因为网状结构（含指针、std::shared_ptr、循环引用、虚函数表）的内存布局不是连续块，sizeof 只返回对象头大小，指针指向的堆内存根本不会被写入。直接 write() 后读取会触发野指针访问或未定义行为。
常见错误现象：Segmentation fault、反序列化后对象字段全为零、std::bad_weak_ptr 异常、std::vector 容量正确但数据为空。
- 不要对含指针成员的类做
memcpy或reinterpret_cast<char*>写入 -
std::string、std::vector等容器必须单独序列化其size()和实际元素，不能只写其对象本身 - 若结构中存在
virtual函数，vptr是编译器插入的隐藏指针，跨进程/重启后绝对不可复用
用 boost::serialization 处理循环引用和智能指针
它通过内部注册机制为每个对象分配唯一 ID，并在序列化时将指针替换为 ID；反序列化时重建对象图并按 ID 修复指针关系——这是解决网状结构的核心能力。
必须显式启用跟踪：对 std::shared_ptr、std::unique_ptr 和自定义类，需在类内声明 BOOST_SERIALIZATION_SPLIT_MEMBER() 或特化 serialize()，否则仍会浅拷贝指针值。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 头文件包含：
#include <boost/archive/binary_oarchive.hpp>、#include <boost/serialization/shared_ptr.hpp> - 对每个参与网状结构的类，必须实现
serialize(Archive&, unsigned)成员函数，且所有成员变量都得显式写入（包括std::shared_ptr<Node>） - 循环引用能自动处理，但前提是两个类都正确注册了序列化逻辑；漏掉任意一个，反序列化时会构造空指针
- 二进制归档（
binary_oarchive）比文本归档快 3–5 倍，且不丢失浮点精度，适合镜像场景
class Node {
public:
std::string name;
std::shared_ptr<Node> parent;
std::vector<std::shared_ptr<Node>> children;
private:
friend class boost::serialization::access;
template<class Archive>
void serialize(Archive& ar, const unsigned int) {
ar & name & parent & children; // 自动处理 shared_ptr 的引用计数与 ID 映射
}
};
手写二进制序列化时如何保证跨平台字节序与对齐安全
直接用 write((char*)&x, sizeof(x)) 在 x86_64 和 ARM64 上可能因默认对齐、enum 底层类型、bool 大小不同而损坏数据。镜像文件需长期可读，不能依赖当前编译环境。
- 所有整数必须用固定宽度类型：
int32_t、uint64_t，避免int或long - 写入前统一转为主机序 → 网络序（大端），用
htons()/htonl()/htobe64()；读取时再转回主机序 - 结构体必须加
[[gnu::packed]]或#pragma pack(1)消除填充字节，否则sizeof不等于各成员之和 - 字符串必须先写长度（
uint32_t），再写 UTF-8 字节流；禁止写c_str()地址或依赖 '\0' 截断
反序列化时如何重建指针网而不泄漏或重复释放
关键不在“读数据”，而在“建图顺序”：必须先一次性分配所有对象（仅调用构造函数，不初始化指针成员），再遍历第二遍修复指针关系。否则早于被引用对象创建的指针会悬空。
使用 std::vector<std::unique_ptr<Node>> 管理原始对象生命周期，用 std::vector<Node*> 或索引映射维护引用关系，严禁在反序列化中途调用 reset() 或 release()。
- 第一步：读取对象总数 N，用
reserve(N)预分配std::vector<std::unique_ptr<Node>>，逐个emplace_back(new Node)（不初始化指针） - 第二步：读取每个对象的字段值（含子对象索引），暂存到临时结构体数组中
- 第三步：遍历临时数组，用索引查表拿到对应
unique_ptr的裸指针，赋给parent、children等成员 - 若用
std::shared_ptr，必须确保所有引用都在同一shared_ptr实例间传递，不能混用裸指针赋值，否则引用计数错乱
uint8_t version = 1; 放在文件头，后续都省去大量排查时间。 
