讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何将结构体快速序列化为二进制文件?(存储技巧)

浅芳吖_7782

浅芳吖_7782

发布时间:2026-03-15 19:56:03

|

685人浏览过

|

来源于php中文网

原创

POD类型结构体才可安全用memcpy序列化,需满足标准布局且无用户定义构造/析构/虚函数;否则会写入padding、指针或未初始化成员,导致读取错误。

c++如何将结构体快速序列化为二进制文件?(存储技巧)

用 memcpy 直接写结构体,但必须满足 POD 类型

能直接二进制序列化结构体的前提是:它得是标准布局(standard layout)且无用户定义构造/析构/虚函数的 POD 类型。否则 memcpy 会把 padding 字节、指针地址或未初始化成员一起写进去,读出来就是错的。

  • 检查方式:编译期加 static_assert(std::is_pod_v<mystruct>, "not POD");</mystruct>
  • 常见破环点:std::string、std::vector、引用成员、非 public 非 static 数据成员混排
  • 有 std::array<int></int> 没问题,但换成 int* 就不行——指针值序列化后毫无意义

示例安全结构体:

struct Point {
    int x;
    int y;
}; // ✅ POD,可 memcpy

写文件时别忽略字节序和对齐差异

结构体在内存里怎么排布,取决于编译器对齐策略和当前平台字节序。跨平台读取时,x86_64 和 aarch64 可能对齐不同;小端机写的文件在大端机上直接读,int32_t 值就全反了。

  • 生产环境强烈建议显式控制:用 #pragma pack(1) 或 alignas(1) 消除 padding,再手动处理字段字节序(如用 htole32())
  • Windows 上默认对齐是 8,Linux GCC 默认也是 8,但若结构体含 __m128 成员,可能自动扩展到 16 —— 写出的文件大小会变
  • 调试技巧:用 sizeof(MyStruct) 和 offsetof(MyStruct, field) 打印布局,确认和预期一致

遇到非 POD 成员(如 std::string)必须手写序列化逻辑

不能靠 memcpy,必须拆开处理:先写长度,再写内容。否则读的时候根本不知道字符串有多长,更没法分配内存。

C++ Code Review Master
C++ Code Review Master

组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

立即学习“C++免费学习笔记(深入)”;

  • 错误写法:write(&s, sizeof(s)) → 写的是 std::string 对象本身(通常 24 字节小对象),不是字符串数据
  • 正确顺序:先 size_t len = s.size(); write(&len, sizeof(len));,再 write(s.data(), len);
  • 注意 size_t 本身跨平台不一致(32/64 位),建议统一用 uint32_t 或 uint64_t
  • 如果结构体嵌套多层(比如 vector of struct),递归处理比幻想“一键序列化”更可靠

用 std::ofstream 的 write() 而不是流插入操作符

<< 是格式化输出,会转成文本,完全违背“二进制”目标;而 write() 才是裸字节搬运工。

  • 务必打开文件时加 std::ios::binary 标志,否则 Windows 下 \n 会被悄悄替换成 \r\n
  • 写完记得调 flush() 或检查 good(),否则缓冲区没落盘,程序一退出就丢数据
  • 不要用 operator<< 写整数然后指望用 read() 读回来——类型不匹配,字节数对不上

典型安全写法:

std::ofstream f("data.bin", std::ios::binary);
f.write(reinterpret_cast<const char*>(&p), sizeof(p));
f.flush();
结构体二进制序列化的坑不在语法,而在类型属性、内存布局、平台约定三者是否对齐。哪怕一个 std::string 成员没处理,整个结构体就失去二进制可移植性。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5699

2023.08.02

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1618

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2424

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

5904

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

5189

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

6914

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

9594

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

4879

2025.07.29

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn