通用文件读写封装：告别重复造轮子，让 C 语言文件操作更高效

    在嵌入式开发、工业软件、底层驱动等场景中，文件读写是高频需求 —— 配置参数存储、日志落盘、固件数据读写，几乎每个项目都绕不开fopen/fwrite/fclose这套基础操作。但每次从零编写不仅效率低，还容易因边界处理疏漏引发 BUG。本文分享一套通用的文件读写封装函数，兼顾健壮性与复用性，可直接嵌入项目使用。

一、封装核心思路：极简接口 + 严格校验

文件操作的核心痛点在于：入参不校验、文件打开失败未处理、读写长度不匹配、资源未释放。因此封装的核心原则是“极简接口 + 全链路校验”：

1. 对外暴露统一的file_opt_write/file_opt_read接口，屏蔽底层fopen/fwrite/fread的细节；
2. 前置入参合法性检查，避免空指针、无效长度导致的崩溃；
3. 对文件打开、读写、关闭全流程做错误处理，每一步异常都返回明确错误码；
4. 统一二进制读写模式（wb/rb），适配跨平台场景（Windows/Linux）。

二、核心封装代码解析

1. 写文件函数file_opt_write

该函数负责将指定长度的数据写入文件，核心逻辑：

• 入参校验：检查文件名、数据指针、长度是否合法，非法直接返回 - 1；
• 以二进制写模式打开文件，失败则打印错误并返回；
• 调用fwri