二進制文件 I/O 是高性能數據持久化、跨進程通訊、嵌入式系統的核心技能。本文從基礎 API 到避坑指南完整覆蓋。
#include <fstream>
// 寫入
std::ofstream ofs("data.bin", std::ios::binary);
int arr[10] = {0, 1, 11, 111, 1111, 11111, 111111, 1111111, 11111111, 111111111};
for (int i = 0; i < 10; ++i) {
ofs.write(reinterpret_cast<const char*>(&arr[i]), sizeof(arr[i]));
std::cout << "pos[" << i << "] = " << ofs.tellp() << '\n';
}
ofs.close();
// 讀取
std::ifstream ifs("data.bin", std::ios::binary);
int val;
while (ifs.read(reinterpret_cast<char*>(&val), sizeof(val))) {
std::cout << val << ' ';
}
ifs.close();
std::ios::binary 必須指定:Windows 下文本模式會轉換 \n↔\r\n,破壞二進制數據reinterpret_cast<char*>:write/read 接受 char*,需從任意類型指標轉換sizeof(T) 單位為位元組:確保寫入/讀取位元組數一致if (!ofs)、ifs.gcount() 確認實際讀取位元組數| 陷阱 | 後果 | 解決方案 |
|---|---|---|
| 直接寫入類對象(含虛函數、指標、STL 容器) | 虛表指標、堆地址、內部指標寫入磁碟,讀出即野指標/崩潰 | 僅序列化 **POD 類型** 或**實現序列化介面**的類 |
| 忽略端序 | 跨平台(x86 ↔ ARM、大端↔小端)讀取錯誤 | 統一用網絡序(大端)或固定小端,htonl/ntohl 或手動位移 |
| 忽略對齊/填充 | 結構體大小跨編譯器/平台不同,讀取錯位 | #pragma pack / alignas / 手動逐字段序列化 |
| 版本演進無兼容機制 | 新舊版本數據格式不兼容 | 文件頭加版本號、魔數、長度前綴;使用 Protobuf/FlatBuffers/Cap'n Proto |
| 浮點數直接寫入 | IEEE 754 表現形式通常一致,但 NaN/無窮大/次正規數處理可能異 | 關鍵場景用定點數/整數縮放或指定序列化格式 |
write(ptr, total_bytes) 單次系統調用mmap/CreateFileMapping:零拷貝隨機訪問ofs.rdbuf()->pubsetbuf(buf, size)std::async + 雙緩衝、IOCP (Windows)、io_uring (Linux 5.1+)二進制 I/O 看似簡單,**正確性在於對數據佈局、平台差異、版本演進的嚴謹掌控**。