C语言文件读写避坑：fopen/fclose与缓冲区实战

简介这份面向C语言初学者的文件读写入门文档围绕文件指针、标准库函数调用和文本文件处理流程展开帮助刚接触持久化存储的读者理解打开、写入、读取与关闭文件的基本方法并建立对返回值和错误检查的初步认识。压缩包内共1个doc文件整体约14KB内容以概念说明配合完整示例代码为主版面轻量便于快速浏览、课堂补充和对照练习。目前已有104人学习适合自学入门、实验课前预习或复习基础接口时查阅。文档通过写入与读取两个示例把FILE指针定义、文件模式选择、fprintf格式化输出、fgets缓冲区读取以及循环判断等环节串联起来读者可据此观察程序结构、理解常见参数含义并尝试修改文件名、写入内容或补充异常处理逐步形成可复用的文件操作思路对后续学习二进制文件与文件定位也有铺垫作用。1. 从一次「文件写进去了读出来却是空的」说起有个 A 同学把课程设计里的学生成绩直接fprintf到data.txt编译运行都过了屏幕上还打印了「写入完成」结果第二天打开文件一看里面干干净净。查了半天才发现程序在fclose之前被一个return提前退出了缓冲区里的数据根本没落盘。这类问题不属于语法错误编译器不会提醒你但它是 C 语言 文件读写 里最常见的一类翻车。这份资源给的就是最朴素的一套东西fopen打开、fprintf/fgets读写、fclose关闭两个完整的示例程序写一个文件再读回来。它不涉及任何第三方库纯stdio.h能直接gcc编译运行。适合刚学完指针和数组、要交课程设计、或者第一次需要把程序结果持久化到磁盘上的新手。下面把它拆开先讲清楚FILE和打开模式的行为边界再把写和读分别讲透最后落到五个真实踩过的坑和一套自检清单。2. 先把 FILE 指针和 fopen 模式吃透六种打开方式的行为差异很多人写文件读写的第一个误区是把FILE *当成「文件本身」。它其实只是标准库给你的一张凭据真正干活的是它背后那套缓冲机制。模式选错、缓冲区没刷后面写再多代码都是白搭。2.1 FILE 不是文件三层结构决定了数据什么时候落盘调用fopen之后标准库会在堆上分配一个FILE结构体里面装着三样关键东西一块缓冲区通常是 4KB 或 8KB、一个读写位置指示器、一个底层文件描述符。你的fprintf调用并不是直接写磁盘而是先往这块缓冲区里塞字符塞满了才触发一次系统调用把整块数据交给内核。这就是为什么程序崩溃时数据会丢——缓冲区还在用户态内存里进程一死就没了。从这个结构能推出两个实操结论。第一fclose不只是「关一下文件」它内部会先做一次fflush把残留缓冲区刷出去所以任何路径退出前都必须走到fclose。第二FILE *是标准库管理的资源不要自己free也不要把栈上的局部变量强行转成FILE *传出去那是野指针。提示stdin、stdout、stderr是三个预先打开好的FILE *其中stderr是无缓冲的所以perror和fprintf(stderr, ...)的输出永远比printf先出现排错时优先用它。2.2 fopen 六种模式的对照表加不加 到底差在哪资源里的示例只用了w和r但实际项目里模式选错导致数据被清空的事故太多了。下面这张表是必须背下来的模式文件不存在文件已存在起始位置是否清空原内容r返回 NULL正常打开开头否w创建新文件打开开头是截断为 0 字节a创建新文件打开末尾否r返回 NULL正常打开开头否w创建新文件打开开头是截断为 0 字节a创建新文件打开读在开头、写在末尾否最容易出问题的是w。它只要打开成功就立刻把文件长度截成 0不管你后面写不写。有人为了「先打开看看文件里有什么」用了w结果原数据当场没了。要读用r要追加用a要既读又写且保留原内容用r只有确定要覆盖重写时才用w。模式字符串后面还可以加b比如rb、wb。在 Linux 上b是空操作但在 Windows 上它会关掉换行符转换文本模式下写\n会被自动变成\r\n读的时候又把\r\n还原成\n。一旦你把同一个文件在两种平台间来回拷这个转换就会让文件长度对不上二进制文件结构体、图片必须带b。2.3 把 fopen 包一层让失败信息能直接定位问题fopen失败只返回NULL光打印一句「无法打开文件」等于没排错。标准库留了errno这个全局错误码配合strerror能翻译成人话。我一般会先写一个小的打开封装后面所有示例都用它#include stdio.h #include errno.h #include string.h /* 打开文件失败时把路径、模式和具体错误原因一起打到 stderr */ FILE *open_or_report(const char *path, const char *mode) { FILE *fp fopen(path, mode); if (fp NULL) { /* strerror(errno) 会把 ENOENT、EACCES 这类错误码翻译成可读文本 */ fprintf(stderr, fopen(%s, \%s\) 失败: %s\n, path, mode, strerror(errno)); return NULL; } return fp; }三个参数各自的作用path是文件路径mode是上面表格里的模式串返回值要么是有效FILE *要么是NULL。errno是errno.h里的宏fopen失败时会被置成具体值常见的几个是ENOENT路径不存在、EACCES权限不足、EMFILE进程打开的文件句柄超限。strerror接收错误码返回静态字符串不要对它返回的指针做修改或free。这里还有一个容易被忽略的点errno只在函数失败的那一刻有意义如果你在fopen和打印之间又调用了别的库函数errno可能已经被覆盖。所以要么立刻打印要么先把errno存到一个int变量里再处理。路径本身也是坑源。写example.txt是相对路径相对于进程的当前工作目录不是相对于源文件所在目录。在 IDE 里点运行和在终端里./a.out工作目录可能完全不同于是同一份代码在一处能跑、另一处报ENOENT。新手阶段我的建议是先用绝对路径确认逻辑通不通再改成相对路径并且把getcwd打印出来看一眼。3. 写文件fprintf、fputs、fwrite 的适用边界与返回值写入这块资源里只演示了fprintf但实际场景里文本和二进制是两条完全不同的路线。选错路线轻则文件里多出一堆看不懂的字符重则换台机器就读不出来。3.1 fprintf格式化写入以及必须检查的返回值fprintf的用法和printf几乎一样只是第一个参数多了个FILE *。它适合写人类可读的文本比如 CSV、日志、配置。下面这段把三个学生的成绩写成 CSV同时演示返回值检查#include stdio.h int main(void) { FILE *fp fopen(scores.csv, w); if (fp NULL) { perror(fopen); return 1; } const char *names[] {A同学, B同学, C同学}; int scores[] {88, 92, 76}; for (int i 0; i 3; i) { /* fprintf 返回实际写入的字符数负数表示出错比如磁盘满 */ if (fprintf(fp, %s,%d\n, names[i], scores[i]) 0) { perror(fprintf); fclose(fp); /* 出错也要关否则句柄泄漏 */ return 1; } } /* fclose 自身也可能失败缓冲区刷盘失败时它会返回 EOF */ if (fclose(fp) ! 0) { perror(fclose); return 1; } return 0; }逐个参数说第一个参数是打开好的FILE *第二个是格式串%s对应字符串、%d对应 int、%f对应 double后面的可变参数必须和格式符一一对应类型不匹配是未定义行为printf系列不会帮你检查。返回值是写入的字符数写失败返回负值。fclose的返回值经常被无视。它返回 0 表示成功返回EOF表示刷盘或关闭失败。磁盘写满的情况只有到fclose才会暴露出来因为前面fprintf只是往缓冲区里塞。所以判断「写成功没有」光看fprintf不够必须把fclose的返回值也接住。3.2 fputs 与 fputc纯文本场景更省事的两个函数不需要格式化的时候fputs比fprintf更直接。它接受一个字符串和一个FILE *把字符串写进去不追加换行fputs(Hello, World!\n, fp); /* 换行要自己写在字符串里 */ fputc(\n, fp); /* 单字符写入适合逐字符生成内容 */fputs遇到字符串结束符\0就停所以它不能用来写含\0的二进制数据。fputc每次写一个字符看起来效率低但在有缓冲的前提下实际的系统调用次数是一样的只是多了一层函数调用开销。真正需要极致吞吐时用fwrite一次性写一大块。注意puts和fputs长得像但不一样puts自动追加换行且只能写stdoutfputs不追加换行且可以写任意流。新手混用之后经常发现文件末尾少一个空行或者多一个空行。3.3 fwrite结构体落盘的 sizeof 陷阱与平台差异要存结构体数组fwrite是最省事的#include stdio.h typedef struct { int id; char name[32]; double score; } Record; int main(void) { Record list[2] { {1, A同学, 91.5}, {2, B同学, 87.0}, }; FILE *fp fopen(records.bin, wb); /* 二进制模式必须带 b */ if (fp NULL) { perror(fopen); return 1; } /* 参数数据首地址、单个元素字节数、元素个数、文件指针 */ size_t n fwrite(list, sizeof(Record), 2, fp); if (n ! 2) { fprintf(stderr, 只写入了 %zu 条\n, n); fclose(fp); return 1; } fclose(fp); return 0; }fwrite的返回值是成功写入的元素个数不是字节数。上面返回 2 才代表两条都写进去了返回 1 说明只写成功一条。结构体直写有三个隐藏问题。第一sizeof(Record)包含了编译器插入的对齐填充字节int后面可能有 4 字节空洞这些字节的内容是未定义的写进文件里也没意义但会让文件变大。第二不同编译器、不同架构的对齐规则可能不同在一台机器上写的.bin换一台机器fread回来可能错位所以这种格式只适合「本机写、本机读」的临时缓存。第三name是定长数组超过 31 个字符就会溢出赋值时必须用snprintf而不是strcpy。如果结构体里有char *指针绝对不能直接fwrite整个结构体——写进去的是地址值换次运行地址就变了读回来是野指针。正确做法是先把字符串内容序列化成「长度 字节」或者定长数组再写。3.4 fflush 与 fclose数据到底什么时候真正落到磁盘前面提过缓冲区的存在。标准库的缓冲策略分三种文件流默认全缓冲缓冲区满、fflush、fclose时才真正写终端流是行缓冲遇到\n就刷stderr无缓冲。需要「写完立刻让别人能读到」的场景就得手动fflushfprintf(fp, 进度: %d%%\n, 50); fflush(fp); /* 强制把缓冲区内容交给内核此时另一个进程就能读到 */典型场景是写日志文件程序还在跑你想用tail -f实时看。不fflush的话日志会攒在缓冲区里看起来像卡住了。但fflush只保证数据交给了内核不保证落到物理磁盘。要抗断电还得fsync(fileno(fp))这是 POSIX 的范畴标准 C 不提供。新手阶段知道这一层就够了fflush解决「别的进程看不见」fclose解决「数据不丢」两件事别混。还有一个常见误用对只读流调用fflush。标准规定对输入流用fflush是未定义行为虽然很多实现默默容忍了但换个编译器可能出问题。写完要刷读完不用刷。4. 读文件fgets 的行边界以及 feof 为什么不能当循环条件读取比写入更容易出隐蔽 bug因为错误往往表现为「内容对了但多了一行」或者「最后一行少了半截」程序不崩你以为对了交上去被扣分。4.1 fgets 的第二个参数sizeof(buffer) 和 sizeof(指针) 的天壤之别资源里的读示例用了fgets(buffer, sizeof(buffer), fp)这是正确写法因为buffer是数组sizeof能拿到真实长度。但如果把它抽成一个函数void read_all(FILE *fp) { char buf[256]; char *p buf; /* 错误示范sizeof(p) 在 64 位下是 8一行只能读到 7 个字符 */ while (fgets(p, sizeof(p), fp) ! NULL) { } }sizeof是编译期运算符对数组返回整个数组字节数对指针返回指针本身大小8 字节或 4 字节。参数一退化就出错。稳妥做法是把长度一起传进来void read_lines(FILE *fp, char *buf, size_t cap) { /* fgets 最多读 cap-1 个字符遇到 \n 或 EOF 提前结束末尾自动补 \0 */ while (fgets(buf, (int)cap, fp) ! NULL) { printf(%s, buf); } }fgets的语义要记牢三条最多读n-1个字符读到换行符就停并且把换行符保留在缓冲区里读完自动在末尾补\0。所以打印时用printf(%s, buf)就够了不要额外加\n否则会多出空行——很多人第一次读文件发现行距变大就是这个原因。当一行长度超过n-1时fgets会截断剩下的部分留在流里下一次调用继续读。这意味着你不能假设「一次fgets等于一行」。判断是否读到完整一行的办法是看缓冲区末尾是不是\nsize_t len strlen(buf); if (len 0 buf[len - 1] \n) { /* 完整一行 */ } else { /* 被截断了需要继续读并拼接 */ }4.2 用 feof 做循环条件为什么会多打印一行这是 C 语言文件读写的经典坑几乎每个人都踩过/* 错误写法 */ while (!feof(fp)) { fgets(buf, sizeof(buf), fp); printf(%s, buf); }问题在于feof的语义是「上一次读操作是否遇到了文件末尾」它是事后标记不是事前预测。文件最后一行读完后feof还没置位循环再进一次fgets这次失败返回NULL缓冲区内容没变于是最后一行被原样打印了第二遍。正确写法是拿读函数的返回值当条件/* 正确写法fgets 返回 NULL 就说明读完了或出错 */ while (fgets(buf, sizeof(buf), fp) ! NULL) { printf(%s, buf); } /* 循环结束后再区分是正常读完还是出错 */ if (ferror(fp)) { perror(读文件出错); }feof不是不能用而是只能在循环结束后用来判断「是读完了还是出错了」配合ferror一起。同理fread的循环条件也不能写!feof。4.3 fscanf 与 sscanf 组合把一行拆成多个字段fscanf可以直接按格式从流里取数据但它有两个毛病一是遇到格式不匹配就停下剩下的内容留在流里很难恢复二是对换行的处理很模糊%d会自动跳过所有空白包括换行容易把两行数据混在一起。我的习惯是先用fgets读整行再用sscanf在内存里拆。这样格式错一行只影响这一行不会污染后续读取#include stdio.h int main(void) { FILE *fp fopen(scores.csv, r); if (fp NULL) { perror(fopen); return 1; } char line[256]; int line_no 0; while (fgets(line, sizeof(line), fp) ! NULL) { int id; char name[32]; double score; line_no; /* %31s 限定最多读 31 个字符留 1 字节给 \0防缓冲区溢出 */ int got sscanf(line, %d,%31[^,],%lf, id, name, score); if (got ! 3) { fprintf(stderr, 第 %d 行格式不对跳过: %s, line_no, line); continue; } printf(id%d name%s score%.1f\n, id, name, score); } fclose(fp); return 0; }关键参数说明%31[^,]是扫描集表示「读最多 31 个非逗号字符」这比%s安全得多%s没有长度限制遇到超长字段会直接写穿栈。sscanf的返回值是成功赋值的字段个数等于 3 才算完整解析了一行。循环里用continue跳过坏行而不是break这样单个脏数据不会让整个文件读不下去。4.4 fread 读二进制返回值是条目数不是字节数和fwrite对称fread的返回值也是成功读到的元素个数Record buf[16]; size_t n fread(buf, sizeof(Record), 16, fp); /* n 可能小于 16说明读到了文件末尾或出错 */ for (size_t i 0; i n; i) { printf(%d %s %.1f\n, buf[i].id, buf[i].name, buf[i].score); } if (ferror(fp)) { perror(fread); }判断「读完了」应该看n 请求数再看feof(fp)确认是正常结束看ferror(fp)确认是否出错。不能只看n 0就以为是空文件也可能是格式不对导致一个完整元素都凑不齐。二进制读还有一个前提写和读必须用同一个结构体定义、同一套编译选项。中途改了结构体字段顺序或者换了个编译器读出来的数据就全乱了。5. 避坑与排查五个真实翻车现场的现象、原因和解决这一章是这份资源里最值钱的部分。示例代码只有几十行但把它放到真实环境里下面五类问题至少会碰到三类。5.1 现象文件里明明有中文读出来是乱码现象写入时屏幕上中文正常用记事本打开文件也正常但程序读回来打印到终端变成一堆问号或者方块。原因两个环节可能出问题。一是源文件编码和终端编码不一致源文件存的是 UTF-8Windows 控制台默认代码页是 936GBK输出时按 GBK 解释 UTF-8 字节自然乱码。二是文件本身被写成了 UTF-8但读取端按 GBK 解析。解决先统一编码。Linux 和 macOS 终端默认 UTF-8一般不用管Windows 上可以在程序开头调用SetConsoleOutputCP(65001)把控制台切到 UTF-8或者把源文件另存为 GBK。判断文件真实编码不要靠猜用十六进制查看器看前几个字节UTF-8 的中文是三个字节一组GBK 是两个字节一组。注意这只是文本编码问题和b模式无关二进制模式不会帮你转换编码。5.2 现象程序在 fclose 处崩溃或者报 double free现象写入过程一切正常执行到最后一行fclose(fp)时程序直接挂掉调试器指向fclose内部。原因三种可能。一是同一个fp被fclose了两次第二次操作的是已经释放的内存。二是fp在某个分支里被fclose后没有置空后续代码又用了一次。三是把栈上的局部变量地址强转成FILE *传给了fclose。解决养成「关完置空」的习惯if (fp ! NULL) { fclose(fp); fp NULL; /* 防止后续误用重复 close 前先判空 */ }所有提前return的分支都要走同一个清理出口用goto cleanup在 C 里是完全合理的写法比在每个分支里复制一遍fclose更不容易漏。5.3 现象写入返回成功重新打开文件却是空的现象fprintf没报错屏幕上「写入完成」也打印了但用编辑器打开文件是 0 字节。原因按可能性排序。第一程序在fclose之前异常退出或走了return缓冲区没刷。第二用了w模式打开一个已有文件做「读一下看看」打开瞬间就清空了。第三写的是相对路径实际写到了另一个工作目录下的同名文件你打开的是旧文件。解决第一步在fclose后立刻用fopen(path, r)重新打开验证长度fseek到末尾用ftell拿大小为 0 就说明没写进去。第二步打印getcwd确认工作目录。第三步检查所有return路径是否都经过了fclose。这个排查顺序是从最常见到最罕见一般第一步就能定位。5.4 现象读大文件时最后一行不完整或者程序卡死现象几千行的日志文件读出来最后一行少了一半或者某个文件读着读着进入死循环。原因前者是fgets缓冲区太小一行超过n-1个字符被截断而代码没有拼接逻辑直接把半行当完整行处理了。后者通常是循环条件写错比如用了while (!feof(fp))但循环体里fgets失败后没有break或者fscanf遇到不匹配的字符后不消费输入指针原地打转。解决把缓冲区开到 1024 或 4096并且在读完之后检查末尾有没有\n没有就说明被截断需要再读一次拼上。对于fscanf循环固定加上返回值判断while (fscanf(fp, %d, v) 1) { /* 处理 v */ } /* 返回值不等于 1 就退出不会死循环 */处理不确定行长的文件更稳的方案是用getlinePOSIX或者自己写一个动态扩容的读取函数按需realloc不要赌一个固定长度。5.5 现象Windows 上写的文件Linux 上解析多出一个字符现象在 Windows 下生成的 CSV拿到 Linux 上用sscanf解析最后一个字段总是多一个不可见字符strcmp比较失败。原因Windows 文本模式写入时把\n转成了\r\nLinux 读取时不做反向转换于是每行末尾留着\r。printf打出来看不明显但字符串比较和数值解析都会受影响。解决跨平台传输的文件统一用二进制模式wb/rb打开自己控制换行符或者在读取后手动剥掉行尾的\rsize_t len strlen(line); while (len 0 (line[len-1] \n || line[len-1] \r)) { line[--len] \0; }这段清理逻辑建议封装成函数所有按行读取的地方都过一遍成本很低能省掉大量「为什么字符串比较不相等」的排查时间。6. 进阶一步用 fseek/ftell 做文件大小校验与随机读写前面所有操作都是顺序读写实际项目里经常需要「跳到某个位置读一条」或者「先量一下文件多大再决定怎么读」。这两个需求靠fseek和ftell解决。#include stdio.h /* 返回文件字节数失败返回 -1 */ long file_size(const char *path) { FILE *fp fopen(path, rb); if (fp NULL) { perror(fopen); return -1; } /* SEEK_END 把位置指针移到末尾偏移 0 表示就停在末尾 */ if (fseek(fp, 0, SEEK_END) ! 0) { perror(fseek); fclose(fp); return -1; } long size ftell(fp); /* 当前位置距文件开头的字节偏移此时就是文件大小 */ fclose(fp); return size; }fseek的三个参数是文件指针、偏移量、基准位置。基准位置有三个常量SEEK_SET从头算、SEEK_CUR从当前位置算、SEEK_END从末尾算。返回值 0 表示成功非 0 表示失败对普通磁盘文件基本不会失败但对管道和终端会。随机读一条记录的写法是先算出偏移再定位/* 读第 index 条记录从 0 开始 */ int read_record_at(FILE *fp, long index, Record *out) { long offset index * (long)sizeof(Record); if (fseek(fp, offset, SEEK_SET) ! 0) return -1; /* fread 返回 1 才算完整读出一条 */ return (fread(out, sizeof(Record), 1, fp) 1) ? 0 : -1; }这个技巧能成立的前提是记录定长也就是 3.3 节说的「结构体直写」格式变长文本用不了。有个边界必须知道ftell返回long32 位 Linux 上long是 4 字节文件超过 2GB 就会溢出返回 -1。要处理大文件得用fseeko/ftelloPOSIX或者 Windows 的_fseeki64/_ftelli64。新手项目一般碰不到但写工具类程序时要提前想到。下面这张表是我每次写完文件相关代码都会过一遍的自检清单检查项合格标准常见不合格表现打开返回值每个fopen后都判NULL直接使用段错误模式选择覆盖用w追加用a保留原内容用r全部用w数据被清空关闭路径所有return分支都经过fclose提前返回数据丢失fclose返回值写入场景检查是否为EOF磁盘满时静默失败读循环条件用fgets/fread返回值判断用!feof末行重复缓冲区长度数组用sizeof指针传capsizeof(指针)只读 7 字节字符串格式符%31s或%31[^,]带宽度裸%s栈溢出换行符处理跨平台读取时剥掉\r字符串比较莫名失败这套清单里的每一条我都在不同项目里被咬过一次。最惨的是fclose返回值那条一个批量导出功能在测试机上跑了三个月都正常上线后某台机器磁盘配额满了导出函数返回成功、文件却是半截用户拿着残缺数据来问查了两天才定位到fclose的返回值被忽略了。从那以后我每次写文件相关的代码打开判空、循环判返回值、关闭判 EOF 这三步都强制走一遍不管代码多短。希望帮到你。本文还有配套的精品资源点击获取