fopen模式错误、缓冲未刷新、参数顺序混淆、跨流混用、字节序与对齐问题导致文件操作失败。需严格区分文本/二进制模式，及时flush/close，校验返回值，用固定宽度类型和显式序列化保证跨平台一致性。
用 fopen 打开文件时，模式字符串写错就直接失败
很多人以为 "w" 和 "wb" 只是“要不要二进制”的区别，其实它直接影响换行符处理和平台兼容性。Windows 下用 "w" 写 \n 会被自动转成 \r\n，而 "wb" 不会——如果你在写协议数据、图片或需要精确字节布局的场景，必须用 "wb"，否则读出来内容对不上。
常见错误现象：fopen 返回 NULL，但没检查 errno 或打印错误原因，只当“路径不对”瞎调。
- 文本模式（
"w","r"）适合纯 ASCII 日志、配置文件；二进制模式（"wb","rb"）才是 C++ 中操作原始数据的默认选择 - 路径含中文或空格时，Windows 下
fopen可能静默失败，建议先用绝对路径测试 - Linux/macOS 对路径敏感，
"./data.txt"和"data.txt"可能指向不同位置，别依赖当前工作目录
fwrite 写不进去？大概率是没关文件或缓冲没刷
fwrite 是带缓冲的，它把数据先塞进内存缓冲区，不一定立刻落盘。如果写完没调 fclose 或 fflush，程序退出时缓冲区可能被丢弃——尤其调试时加了断点或提前 return，文件看起来就是空的或缺最后几段。
另一个高频坑：参数顺序记混。fwrite(ptr, size, count, fp) 的 size 是单个元素字节数，count 是元素个数，不是总字节数。写 int arr[10] 应该是 fwrite(arr, sizeof(int), 10, fp)，而不是 fwrite(arr, 1, 40, fp)——后者在结构体对齐或大小端混合场景下极易出错。
立即学习“C语言免费学习笔记（深入）”；
- 写完务必检查返回值：
size_t ret = fwrite(...); if (ret != count) { /* 写入异常 */ } - 调试阶段可在
fwrite后加fflush(fp)，确认数据已提交到 OS 层 - 不要对同一个
FILE*混用fread/fwrite而不调fseek，C 标准规定这是未定义行为
C++ 里混用 fopen 和 std::ofstream 很危险
一个文件用 fopen 打开，又用 std::ofstream 去操作同一路径，不会报错，但两个流各自维护缓冲区和文件偏移，结果不可预测。更隐蔽的是：C++ 流析构时自动 close，而你手写的 fclose 可能重复关闭同一句柄，触发 SIGSEGV 或静默损坏。
典型场景：封装了一个日志函数用 fopen+fwrite，后来想加格式化又引入 std::ostringstream，最后直接 file ——这已经不是风格问题，是资源管理冲突。
- 项目里统一选一套 I/O 风格：纯 C 风格就全程用
FILE*系列；C++ 风格就用std::fstream，别交叉 - 如果必须对接 C 库（比如某个 SDK 只收
FILE*），用std::ofstream的rdbuf()->pubsetbuf(nullptr, 0)关缓冲，再用fileno()提取 fd，但注意这属于非标扩展，glibc 和 musl 表现可能不同 - RAII 不是银弹：
std::unique_ptr<file decltype></file>可以帮你自动关，但得确保构造时fopen成功，且不用std::move错误转移所有权
跨平台写二进制文件，sizeof 和字节序不能靠猜
fwrite(&x, sizeof(x), 1, fp) 在 x86_64 和 ARM64 上通常没问题，但一旦涉及结构体、short/int 混用，或者要让 Windows 编译的文件能在嵌入式设备上读，sizeof 就不可信——不同编译器、不同 ABI 下，对齐方式、填充字节、甚至 int 的实际宽度都可能不同。
比如 struct { char a; int b; }，在 x86-64 Linux gcc 下 sizeof 是 8，但在某些嵌入式工具链下可能是 5（禁用对齐）或 12（强制 8 字节对齐）。直接 fwrite 这个 struct，对方 fread 出来就是错的。
- 固定宽度类型优先：
int32_t,uint8_t，配合htonl/ntohl统一网络字节序（大端） - 结构体写入前手动序列化：逐字段
fwrite，跳过 padding，或用#pragma pack(1)强制紧凑，但需两端一致 - 写完用
ftell校验写入长度，比预期少说明有截断或写入失败，别假设fwrite总是全成功
事情说清了就结束。最麻烦的从来不是怎么写，而是哪天你发现文件里多出几个 \r、少读了两个字节、或者结构体字段突然错位——那八成是模式、缓冲、对齐、字节序这四个点里，有一个被当成“理所当然”跳过了。
