49.C语言本地文件读写实战：从基础到嵌入式应用-开发者社区

一、文件操作的核心逻辑

文件操作的本质是实现“内存临时数据”与“磁盘持久化数据”的交互，核心流程可概括为三步：

打开文件：通过fopen建立程序与文件的连接，指定读写模式；
读写数据：使用fprintf/fscanf等函数完成数据的写入或读取；
关闭文件：通过fclose释放资源，避免数据丢失和内存泄漏。

二、核心函数与实战代码

1. 基础写入示例

#include <stdio.h> // 引入标准输入输出头文件，提供文件操作函数声明 int main(void) { // 声明一个文件指针变量 fp，用于指向被操作的文件 FILE *fp; // 以写入模式打开文件 "data.txt" // fopen 函数：第一个参数是文件路径字符串，第二个参数是模式字符串 "w" // "w" 模式：如果文件不存在则创建，如果存在则清空原有内容 // 返回值：成功打开则返回一个 FILE 指针，失败则返回 NULL fp = fopen("data.txt", "w"); // 检查文件是否成功打开，这是文件操作中必须的异常处理 if(fp == NULL) { printf("文件打开失败！\n"); return -1; // 返回错误码，表示程序异常结束 } // 使用 fprintf 函数向文件写入格式化数据 // 第一个参数是文件指针 fp，指定数据写入的目标文件 // 第二个参数是格式化字符串 "温度: %.1f ℃\n"，与 printf 用法相同 // %.1f 表示以浮点数格式输出，保留一位小数 // 第三个参数 25.6 是要写入的实际数据 fprintf(fp, "温度: %.1f ℃\n", 25.6); // 使用 fclose 函数关闭文件，释放系统资源 // 关闭文件会将缓冲区中的数据真正写入磁盘，避免数据丢失 fclose(fp); return 0; // 程序正常结束 }

代码说明：

fopen("data.txt", "w")：以写入模式打开文件，文件不存在则创建，存在则清空原有内容；
fprintf：格式化写入函数，语法与printf类似，第一个参数为文件指针；
fclose：必须调用，否则缓冲区数据可能无法写入文件，导致数据丢失。

2. 常用打开模式

模式	功能说明	适用场景
"w"	写入模式，文件不存在则创建，存在则清空	全新数据写入
"r"	只读模式，文件不存在则打开失败	读取已有文件
"a"	追加模式，保留原有内容，新数据写入末尾	日志追加、历史数据记录
"w+"	读写模式，文件不存在则创建，存在则清空	需同时读写的场景
"r+"	读写模式，文件必须存在	已有文件的修改与读取

3. 读取文件示例

#include <stdio.h> // 引入标准输入输出头文件 int main(void) { // 声明文件指针 fp，用于指向要读取的文件 FILE *fp; // 声明一个浮点变量 temp，用于存储从文件中读取的温度值 float temp; // 以只读模式打开文件 "data.txt" // "r" 模式：文件必须存在，否则打开失败（返回 NULL） // 文件指针 fp 将指向文件的开头，准备读取数据 fp = fopen("data.txt", "r"); // 检查文件是否成功打开 if(fp == NULL) { printf("文件打开失败！\n"); return -1; // 打开失败，程序异常退出 } // 使用 fscanf 函数从文件中读取格式化数据 // 第一个参数是文件指针 fp，指定数据来源 // 第二个参数是格式化字符串 "温度: %f ℃\n"，用于匹配文件中的数据格式 // %f 是格式说明符，表示读取一个浮点数 // 第三个参数 &temp 是变量 temp 的地址，fscanf 会将读取到的值存入该地址 // 注意：格式化字符串必须与文件中的实际数据格式严格匹配，否则读取会失败 fscanf(fp, "温度: %f ℃\n", &temp); // 将读取到的温度值打印到控制台，%.1f 表示输出保留一位小数 printf("读取到的温度: %.1f ℃\n", temp); // 关闭文件，释放资源 fclose(fp); return 0; // 程序正常结束 }

三、嵌入式开发延伸应用

在嵌入式开发中，文件操作常用于：

SD卡存储：保存设备运行日志、传感器历史数据；
参数保存：存储设备校准参数、配置信息，断电后数据不丢失；
日志记录：记录设备运行状态、错误信息，便于故障排查。

嵌入式场景下的文件操作逻辑与标准C语言完全通用，仅需注意：

文件路径需根据嵌入式系统的存储介质调整（如/sdcard/data.txt）；
需确保存储介质已正确挂载；
异常处理需更严格，避免因文件操作失败导致系统崩溃。

1. SD卡存储示例：保存传感器数据

#include <stdio.h> #include <string.h> /** 功能：将传感器数据（温度、湿度）追加写入SD卡文件 文件路径：/sdcard/sensor_log.csv 模式："a" (追加模式，保留历史数据) */ int save_sensor_data_to_sd(float temperature, float humidity) { FILE *fp; // 嵌入式系统中，SD卡通常挂载在特定路径下，如 /sdcard/ const char *file_path = "/sdcard/sensor_log.csv"; // 以追加模式打开文件，新数据写在文件末尾 fp = fopen(file_path, "a"); if (fp == NULL) { // 嵌入式系统通常使用专用日志接口，这里简化为 printf printf("[ERROR] 无法打开文件: %s\n", file_path); return -1; // 返回错误码 } // 写入CSV格式的数据：时间戳(模拟),温度,湿度 // 实际项目中应获取实时时间戳 fprintf(fp, "2023-10-27 14:30:00,%.2f,%.2f\n", temperature, humidity); // 关闭文件，确保数据写入物理存储 fclose(fp); printf("[INFO] 传感器数据已保存至: %s\n", file_path); return 0; // 成功返回0 } // 示例调用 int main(void) { // 模拟传感器读数 float temp = 25.6f; float humi = 65.2f; // 调用函数保存数据 int ret = save_sensor_data_to_sd(temp, humi); if (ret != 0) { printf("数据保存失败，请检查SD卡状态和路径。\n"); } return 0; }

代码说明：

文件路径：嵌入式系统中，SD卡通常挂载在/sdcard/、/mnt/sdcard/等路径下，需根据实际系统调整。
打开模式：使用"a"（追加）模式，避免覆盖历史日志。
数据格式：采用CSV格式存储，便于后续用Excel或脚本分析。
错误处理：必须检查fopen返回值，在资源受限的嵌入式系统中尤为重要。

2. 参数保存示例：读写设备配置

#include <stdio.h> // 设备参数结构体（示例） typedef struct { int device_id; // 设备ID float calibration_coef; // 校准系数 int sampling_interval; // 采样间隔(ms) char version[16]; // 固件版本字符串 } DeviceConfig; /** 功能：将设备配置参数保存到Flash/EEPROM模拟的文件中 文件路径：/cfg/device_param.bin 模式："wb" (二进制写入，覆盖旧文件) */ int save_device_config(const DeviceConfig *cfg) { FILE *fp; const char *config_path = "/cfg/device_param.bin"; fp = fopen(config_path, "wb"); // "wb" 二进制写入模式 if (fp == NULL) { printf("[ERROR] 无法创建配置文件: %s\n", config_path); return -1; } // 将整个结构体写入文件（二进制方式） size_t written = fwrite(cfg, sizeof(DeviceConfig), 1, fp); if (written != 1) { printf("[ERROR] 配置文件写入不完整。\n"); fclose(fp); return -2; } fclose(fp); printf("[INFO] 设备配置已保存至: %s\n", config_path); return 0; } /** 功能：从文件加载设备配置参数 模式："rb" (二进制读取) */ int load_device_config(DeviceConfig *cfg) { FILE *fp; const char *config_path = "/cfg/device_param.bin"; fp = fopen(config_path, "rb"); // "rb" 二进制读取模式 if (fp == NULL) { printf("[WARN] 配置文件不存在，使用默认配置。\n"); // 可在此处初始化默认值 return -1; } // 从文件读取整个结构体 size_t read = fread(cfg, sizeof(DeviceConfig), 1, fp); if (read != 1) { printf("[ERROR] 配置文件读取失败或已损坏。\n"); fclose(fp); return -2; } fclose(fp); printf("[INFO] 设备配置已从 %s 加载成功。\n", config_path); return 0; } // 示例：保存并重新加载配置 int main(void) { DeviceConfig my_config = { .device_id = 1001, .calibration_coef = 1.05f, .sampling_interval = 500, .version = "V1.2.3" }; // 保存配置 if (save_device_config(&my_config) == 0) { printf("配置保存成功。\n"); } // 重新加载配置（模拟重启后） DeviceConfig loaded_config; if (load_device_config(&loaded_config) == 0) { printf("加载的配置: ID=%d, 系数=%.2f, 间隔=%dms, 版本=%s\n", loaded_config.device_id, loaded_config.calibration_coef, loaded_config.sampling_interval, loaded_config.version); } return 0; }

代码说明：