必须先在内存中拼成单个std::vector再一次性write()，而非逐个write()追加；正确做法是reserve总大小后用insert()合并，再以binary模式write()。
std::vector 合并写入二进制文件前必须手动拼接内存
直接把多个 std::vector 逐个 write() 进文件不是“合并为一个连续的二进制文件”的等价操作——它只是顺序追加，各段之间仍保留原始边界。若下游（比如 C 接口、内存映射、协议解析）要求所有数据在逻辑上是**一块连续内存块**，就必须先在内存中拼成单个 std::vector<uint8_t></uint8_t>，再一次性写入。
常见错误现象：read() 时按固定偏移解析结构体失败、mmap() 后指针偏移错乱、接收方认为数据截断。
- 不要用
std::vector::insert()在大容器末尾反复插入小向量——每次可能触发多次内存重分配 - 先调用
reserve()预分配总大小，再用insert()或std::copy()追加 - 若向量元素类型非
uint8_t（如int32_t、float），需显式 reinterpret_cast 字节序列，注意字节序和对齐
用 std::vector reserve + insert 拼接最安全
这是零拷贝开销最小、语义最清晰的做法。适用于所有 POD 类型，且避免了 std::memcpy 的裸指针风险。
std::vector<uint8_t> merged;
size_t total_size = v1.size() + v2.size() + v3.size();
merged.reserve(total_size);
<p>merged.insert(merged.end(), v1.begin(), v1.end());
merged.insert(merged.end(), v2.begin(), v2.end());
merged.insert(merged.end(), v3.begin(), v3.end());</p>
<p>std::ofstream file("out.bin", std::ios::binary);
file.write(reinterpret_cast<const char>(merged.data()), merged.size());
</const></p></uint8_t>
-
reserve()后insert()不会重新分配内存，push_back()等价但可读性差 - 如果原始向量是
std::vector<int></int>，先用std::vector<uint8_t>(data, data + size * sizeof(int))</uint8_t>转换，或用std::bit_cast（C++20） - Windows 下注意
std::ofstream必须带std::ios::binary，否则\n会被转成\r\n
写入时用 write() 而非
operator 是格式化输出，会尝试转换为文本，对二进制数据完全不可用；<code>write() 才是原始字节写入。但很多人忽略写入失败的检测。
- 写入后必须检查
file.fail()，尤其在 NFS、USB 存储等不稳定介质上 - 不要依赖
file.good()—— 它只在所有标志位都清零时才为 true，而failbit和badbit都会导致失败 - 写入长度必须与
merged.size()严格一致，write()不保证一次写完（虽然对本地文件通常如此），生产环境应循环写入
跨平台注意字节序和结构体 padding
如果你合并的是结构体数组（如 std::vector<mystruct></mystruct>），光拼接内存还不够：下游解析时若未统一字节序或未处理 padding，数据必然错乱。
- 用
#pragma pack(1)或[[gnu::packed]]消除结构体填充，但会降低访问性能 - 发送前用
htons()/htonl()统一转为网络序（大端），接收方再转回本地序 - 不要假设
sizeof(MyStruct)==offsetof(last_member) + sizeof(last_member)—— 用static_assert校验
真正麻烦的从来不是怎么写进去，而是怎么让另一端按你预期的方式读出来。二进制协议里，结构体定义、字节序、对齐方式这三者缺一不可，漏掉任何一个，文件就只是“能写进去”，而不是“能被正确解释”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
