0

0

C++二进制文件读写常见错误及解决方案【避坑指南】

冰火之心

冰火之心

发布时间:2026-01-20 14:13:25

|

313人浏览过

|

来源于php中文网

原创

根本原因是未指定std::ios::binary标志,导致Windows下文本模式自动转换\r\n和遇0x1A提前终止;还需避免混用C/C++ I/O、结构体直接读写、忽略异常及文本/二进制模式混用。

c++二进制文件读写常见错误及解决方案【避坑指南】

std::ifstream 读二进制文件却读出乱码或数据截断

根本原因通常是没加 std::ios::binary 标志。Windows 下默认文本模式会把 \r\n 自动转成 \n,还可能在遇到 0x1A(EOF 字符)时提前终止读取。

  • 务必在打开文件时显式指定 std::ios::binary
    std::ifstream file("data.bin", std::ios::in | std::ios::binary);
  • 检查 file.is_open()file.good(),不要只依赖构造是否抛异常
  • 读取前用 file.seekg(0, std::ios::end); size_t len = file.tellg(); file.seekg(0); 获取真实字节长度,避免用 file.gcount() 误判

fread / fwritestd::streambuf 混用导致缓冲错乱

C 风格 I/O 和 C++ 流共用同一文件描述符但各自维护缓冲区,混用会跳过或重复读写部分字节,尤其在非全缓冲模式下极难复现。

  • 一个文件对象只用一种风格:要么全程用 fread/fwrite,要么全程用 read()/write()>>/
  • 若必须桥接,调用 file.rdbuf()->pubsync()(C++流)或 fflush()(C流)强制刷缓存,再切换
  • 注意 std::ofstream 默认不缓冲二进制写入,频繁小写建议手动 file.rdbuf()->pubsetbuf(buf, size)

结构体直接 read() 写入后跨平台/编译器读取失败

结构体内存布局受对齐(#pragma pack)、字段顺序、大小端、成员类型(如 bool 占几个字节)影响,不同平台或编译选项下 sizeof(MyStruct) 可能不同。

  • 禁止直接 file.read(reinterpret_cast(&s), sizeof(s)) 传输结构体
  • 改用序列化:逐字段读写,或用 memcpy + 显式字节序转换(如 htons)处理整数
  • 若必须紧凑二进制,统一用 #pragma pack(1) 并静态断言:
    static_assert(sizeof(MyStruct) == 12, "Struct layout changed");
  • 写入前用 file.write(...) 后立即检查 file.gcount() == expected_bytes

未处理 std::ios_base::failure 异常导致程序崩溃

默认情况下 std::ifstream/std::ofstream 不抛异常,但一旦开启 exceptions(std::ios_base::failbit | std::ios_base::badbit)read() 失败、磁盘满、权限不足等都会 throw,没 catch 就 terminate。

Simplified
Simplified

AI写作、平面设计、编辑视频和发布内容。专为团队打造。

下载

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

  • 开启异常前确认你真要它:多数场景用 if (!file) { /* handle */ } 更轻量
  • 若开启,必须包围所有 I/O 操作:
    file.exceptions(std::ios_base::failbit | std::ios_base::badbit);
    try {
        file.read(buf, len);
    } catch (const std::ios_base::failure& e) {
        // 注意:e.what() 可能不包含具体错误码
        int err = errno; // 需在 catch 块内立刻读,errno 可能被后续调用覆盖
    }
  • std::ios_base::eofbit 不触发异常,需单独用 file.eof() 判断是否读到末尾

实际项目里最常被忽略的是:二进制读写路径中夹杂了任何文本操作(比如用 std::getline 读配置后再切回二进制读),哪怕只调用一次,也会让流进入文本状态并污染后续行为。

相关专题

更多
if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

751

2023.08.22

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

197

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

189

2025.07.04

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

197

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

189

2025.07.04

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

601

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1104

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

792

2023.08.01

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

3

2026.01.20

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 4万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号