C语言文件读写入门：fopen、fgets与fclose文本持久化实战

简介这份C语言文件读写学习文档面向刚接触文件操作的初学者围绕如何用标准库把数据写入文件、再从文件读回并输出这一常见需求展开重点降低fopen、fprintf、fgets、fclose等函数的上手门槛。压缩包仅含1个doc文件体积约14KB内容以文字讲解配示例代码为主篇幅轻量便于快速浏览和本地练习。已有104人学习说明适合作为课堂补充或自学入门材料。文档从文件指针、打开模式讲起给出写文件与逐行读文件的完整代码并强调打开失败时返回NULL的检查方式读操作则通过缓冲区循环读取直至文件结束帮助读者理解写入、读取、关闭的基本流程也可作为课程实验和课后练习的参考。1. 先弄明白一件事C语言文件读写到底在解决什么问题刚学C语言那阵子我写了个记账小工具兴致勃勃录了十几条数据窗口一关再打开全没了。当时以为是编辑器出毛病折腾半天才想明白变量活在内存里程序一结束就被清空跟写在草稿纸上又被擦掉一样。C语言文件读写干的就是把这张草稿纸换成笔记本的事——把程序里的内容写进硬盘上的文件或者把文件里的内容取回程序。它不需要额外装什么库标准库里几个函数就够用一行#include stdio.h就能开工。它特别适合刚学完循环、数组想做一个「能记住东西」的小程序的新手。下面从最基础的概念讲起一路带你跑通第一个能写能读的例子。2. 为什么新手值得先学文件读写数据从“关掉就没”到“留下来”2.1 内存里的变量活不长白板和抽屉的区别你在代码里写int score 95;这个 95 存在内存里。内存的特点是快但断电就没程序一退出也清空。你可以把内存想成桌上的一块白板随手写随手擦方便是方便可下班一关灯第二天来了啥也不剩。硬盘就不一样它像办公桌下面的抽屉东西塞进去下次上班拉开还在。文件就是硬盘上的东西。程序自己没法直接伸手去抽屉里翻得通过一组专门的操作函数去读写这一组函数合起来就是常说的文件读写。所以「持久化」这个词听着唬人翻译成人话就是程序关掉以后数据还在。你手机里的通讯录、游戏存档、配置文件本质都是这件事。入门阶段不用管数据库、不用管序列化框架把文本文件读写弄明白已经能支撑很多小项目了。我第一次真正用上它是做一个命令行通讯录。之前每次测试都要手动重新输入十几个联系人烦得想砸键盘。改成从文件里读之后测试前先把测试数据写进contacts.txt程序一跑就加载好那感觉跟装了后悔药一样。2.2 文件读写在实际小项目里长什么样入门阶段碰到的文件绝大多数是纯文本一行一条记录字段之间用逗号、空格或者制表符隔开。比如通讯录可以长这样张三,13800000000 李四,13900000000这种格式的好处是肉眼能看懂。程序读出来不对你直接双击打开文件看一眼就知道问题出在哪不用面对一堆二进制黑匣子。对刚上手的人来说可视性比性能重要一百倍。常见的几类场景你可以对照一下通讯录、待办清单一行一条程序启动时全部读进数组退出前整个写回去。成绩统计把一批数字存文件程序读完算平均分、最高分再把结果写到另一个文件。配置项窗口大小、上次打开的文件名存成keyvalue的形式启动时读一下。运行日志程序跑到哪一步、出了什么错往文件末尾追加一行出问题时翻日志比盯着屏幕猜强得多。这些场景的共同点是数据结构不复杂操作也就那么几下打开、读或者写、关闭。真正难的不是函数本身而是路径写错、模式选错、忘了关闭这类细节。下一章就从一个最小可运行的例子开始把这些细节一个个落地。2.3 入门只需要记住三步打开、读写、关闭不管多复杂的文件操作骨架永远是三步你可以拿借书柜打比方第一步走到柜子前用钥匙把门打开拿到一个把手。对应代码里就是fopen它返回一个FILE *类型的指针。这个指针不是文件本身只是你操作这个文件时用的把手记住这一点后面很多报错就解释得通了。第二步从柜子里拿书或者往里放书。对应fprintf、fputs、fgets、fscanf这些读写函数它们都拿着刚才那个把手干活。第三步把门关上把钥匙还回去。对应fclose。这一步最容易被新手省略反正程序跑完系统也会收尾看起来不写也行。但写文件时数据可能还卡在缓冲区里没真正落盘不关闭就可能丢内容这一点后面避坑那一章会专门讲。打开这一步还有个必须养成的习惯检查返回值。文件可能因为路径不存在、没有权限、磁盘满了而打不开这时fopen返回NULL。你要是拿着一个空把手去读写程序当场崩溃报错信息还看不出所以然。FILE *fp fopen(data.txt, r); if (fp NULL) { // 打开失败必须先拦下来 printf(无法打开文件\n); return 1; }这段检查只有三行却能省掉你以后半夜排查崩溃的大把时间。入门阶段别嫌它啰嗦每次都写。3. 第一个例子把两行字写进 example.txt3.1 动手前的准备一个空文件夹和一条编译命令先准备一个专门的空文件夹别在桌面或者下载目录里随便建。原因很实际程序生成的文件会落在「当前工作目录」里混在一堆杂七杂八的文件中你找起来会怀疑人生。在文件夹里新建一个write_demo.c把后面的代码粘进去。编译命令是最普通的那种gcc write_demo.c -o write_demo ./write_demo第一行把源码编译成可执行文件-o后面跟的是输出文件名你想叫什么都行。第二行是运行。Windows 上生成的是write_demo.exe在命令行里敲write_demo.exe或者.\write_demo.exe都行。提示如果你用的是带运行按钮的编辑器点按钮也能跑但要留意它把工作目录设成了哪里。文件找不到的时候先回来确认这一点。3.2 写文件的完整代码与逐行解释先完整看一遍不要急着改#include stdio.h int main() { FILE *fp; // 文件指针操作文件全靠这个把手 fp fopen(example.txt, w); // w 写入模式文件不存在就新建 if (fp NULL) { // 打开失败会返回空指针必须拦住 printf(无法打开文件\n); return 1; // 返回非 0 表示程序异常结束 } fprintf(fp, Hello, World!\n); // 往文件里写第一行 fprintf(fp, 这是一个文件写入示例。\n); // 第二行 fclose(fp); // 关闭文件缓冲区内容这时候才落盘 printf(写入完成。\n); return 0; }一行行拆。FILE *fp;声明了一个文件指针。FILE是标准库定义的一个结构体类型你不用关心它里面有什么就把它当成一个把手的类型名。星号表示指针也就是这个把手里存的是某个文件的地址。fopen(example.txt, w)是打开动作两个参数第一个是文件路径第二个是打开模式。这里用的是相对路径意思是「当前工作目录下的 example.txt」。模式w表示只写。if (fp NULL)是错误检查。打开失败的原因很多路径里的文件夹不存在、文件被别的程序占用、没有写权限都会让fopen返回NULL。fprintf(fp, ...)和平时用的printf几乎一样只是多了一个参数放在最前面告诉它往哪个文件写。格式化和printf完全一致%d、%s、%.2f都能用这是它比fputs更好用的地方。fclose(fp)关闭文件。写模式下的数据先进入缓冲区关闭时才真正写进硬盘。省略这一步程序正常结束时通常也会帮你刷新但一旦中途崩溃内容就没了。3.3 跑完去哪看结果工作目录这个概念必须搞懂程序打印「写入完成」之后很多人第一反应是在源码旁边找example.txt结果翻遍文件夹也没有。文件到底去哪了答案是程序运行时的「当前工作目录」里不一定是你放源码的地方。你在命令行里cd到哪个目录再运行程序文件就生成在哪个目录。用编辑器点运行按钮工作目录可能被设成项目根目录。双击 exe 启动工作目录通常是 exe 所在目录。三种情况三个位置这就是新手最常见的「文件凭空消失」事件。排查方法很直接在代码里打印一下当前路径或者干脆先换成绝对路径。// Windows 下反斜杠要写两个或者直接用正斜杠 fp fopen(C:/demo/example.txt, w);绝对路径的好处是位置确定坏处是换台电脑就得改代码。折中的做法是先用绝对路径确认程序逻辑没问题再换回相对路径把文件位置的事交给运行方式去管。注意Windows 路径里的反斜杠\在 C 语言字符串中是转义符C:\demo\a.txt会被解释成别的字符写成C:\\demo\\a.txt或者C:/demo/a.txt才正确。3.4 改几个地方再跑一次模式、内容、格式第一个例子跑通之后别急着往下翻做三个小改动你对模式的理解会扎实很多。改动一把w换成a。a是追加模式文件不存在就新建已存在就在末尾接着写不会清空原有内容。把程序连跑三次打开文件你会看到六行而不是两行。这个模式特别适合写日志每次运行往后面添一笔历史记录全留着。改动二把模式换回w再跑一次。你会发现之前追加的六行全没了只剩新写的两行。这就是w的真实含义打开的同时清空。很多人以为它是「打开已有文件然后写」结果不小心把重要数据覆盖掉血泪经验基本都来自这里。改动三往文件里写数字和变量int score 95; double avg 88.5; fprintf(fp, 分数:%d, 平均分:%.1f\n, score, avg);fprintf的格式串和printf一模一样所以你已经会用了不用重新学一套。写完打开文件看一眼确认95和88.5都在就说明格式化输出没问题。顺便把fopen的常用模式记一下这张表以后会反复用到模式能做什么文件不存在时文件已存在时r只读打开失败返回 NULL从头开始读w只写新建文件清空后重写a只写追加新建文件在末尾接着写r读写打开失败从头读写不清空w读写新建文件清空后重写a读写追加新建文件末尾写可从头读模式后面还能加个b比如rb、wb表示按二进制方式打开。入门阶段处理纯文本用不上知道有这回事就行等以后存结构体数组再回来看。4. 第二个例子把文件内容一行行读回屏幕4.1 读文件的完整代码与逐行解释文件里已经有内容了现在把它读出来打印到屏幕上。新建一个read_demo.c#include stdio.h int main() { FILE *fp; char buffer[256]; // 用来临时存放读到的一行内容 fp fopen(example.txt, r); // r 只读模式文件必须已存在 if (fp NULL) { printf(无法打开文件\n); return 1; } // 每次读一行读到文件末尾返回 NULL循环就结束 while (fgets(buffer, sizeof(buffer), fp) ! NULL) { printf(%s, buffer); // buffer 里已带换行符不用再加 \n } fclose(fp); printf(读取完成。\n); return 0; }char buffer[256];是读操作和写操作最大的不同点。写的时候数据从变量流向文件你不需要准备容器读的时候数据从文件流向程序你得先准备好一块地方接着这就是缓冲区。256 是这一行最多能装下的字符数一般够用装不下就会被截断下一轮循环接着读剩下的部分。fopen(example.txt, r)用只读模式。注意这种情况下文件必须已经存在否则fopen返回NULL你的错误检查会拦住它。这也是为什么第 3 章的例子要先跑一遍。fgets(buffer, sizeof(buffer), fp)三个参数后面单独讲。这里先记住它的返回值成功读到内容就返回buffer的地址读到文件末尾或者出错就返回NULL。printf(%s, buffer)里故意没加\n。因为fgets会把换行符一起读进来你再加一个就会变成空一行、内容一行看起来像程序出毛病。4.2 fgets 的三个参数怎么填为什么这么填三个参数分别是往哪存、最多存多少、从哪读。第一个参数buffer是缓冲区的首地址。数组名本身就代表地址所以直接写数组名就行不用加。第二个参数sizeof(buffer)是缓冲区的大小。fgets最多读size - 1个字符最后一个位置留给字符串结束符\0。所以 256 的缓冲区实际最多存 255 个字符加一个结束符。这里有个写法上的讲究。很多人直接写256也能跑。但哪天你把数组改成char buffer[1024];却忘了改第二个参数就会读进来 1024 个字符塞进 256 的空间直接越界。写sizeof(buffer)让编译器自己算改数组大小时不用连带改参数少一个翻车点。第三个参数fp就是打开时拿到的把手告诉函数从哪个文件读。提示fgets遇到换行符会停下来并且把换行符也存进缓冲区。所以一行读完缓冲区里是「内容 \n \0」三部分。碰上一行特别长、超过缓冲区大小时它不会报错只是先读一段下次循环接着读剩下的这一点在读大文件时要留意。顺带说一句早年教材里常出现的gets函数现在已经不推荐用了它不检查缓冲区大小输入一长就溢出。看到老代码里用它心里有个数就行自己写的时候一律用fgets。4.3 为什么外面要套一层 while 循环文件里有多少行写代码的时候你不知道也不该写死。用循环读到读不出来为止是处理文件的标准姿势。while (fgets(...) ! NULL)的意思是只要还能读到东西就继续循环读到文件末尾fgets返回NULL循环自然结束。整个过程不需要你事先知道行数。新手常写的一种错误版本是这样// 不推荐容易多读一轮 while (!feof(fp)) { fgets(buffer, sizeof(buffer), fp); printf(%s, buffer); }feof判断的是「上一次读操作有没有碰到文件末尾」它不会提前告诉你下一次还能不能读。结果是文件读完以后feof还没被置位循环又转一圈fgets这次什么都没读到缓冲区里是上一轮的旧内容于是最后一行被打印了两遍。这个 bug 很隐蔽因为大多数时候输出看着正常只是末尾多一行。结论很简单判断「读到没读到」用fgets的返回值别用feof当循环条件。这条经验能帮你省下不少盯着输出找多余行的夜晚。还有个细节值得注意。fgets是按行读如果文件里有一行超过缓冲区大小它不会一次读完而是分几轮给你。所以buffer设大一点比如 256 或 1024通常就够真碰上超长行再按块处理。4.4 把读和写接起来一个能存能取的小闭环前面两个例子是分开的实际用的时候基本都连在一起。下面这个小程序每次运行往文件末尾追加一行然后把整个文件读出来打印能很直观地看到「写进去的确实存住了」。#include stdio.h int main() { // 第一步追加模式写入不会覆盖之前的内容 FILE *fp fopen(notes.txt, a); if (fp NULL) { printf(无法打开文件\n); return 1; } fprintf(fp, 今天跑通了文件写入\n); fclose(fp); // 必须先关后面的读才能看到新内容 // 第二步重新以只读模式打开把全部内容读出来 fp fopen(notes.txt, r); if (fp NULL) { printf(无法打开文件\n); return 1; } char line[256]; while (fgets(line, sizeof(line), fp) ! NULL) { printf(%s, line); } fclose(fp); return 0; }注意中间那次fclose不能省。写完不关就立刻用读模式打开同一个文件有些平台上读到的是空内容或者旧内容因为写的数据还卡在缓冲区里没落盘。关一次等于强制刷新一次。连续运行三遍屏幕上会出现三行「今天跑通了文件写入」。这个现象本身就说明追加模式起作用了也说明数据真的持久化了。把程序关掉、电脑重启再打开notes.txt三行还在这就是文件读写和内存变量最本质的区别。5. 新手最容易踩的坑文件读写排查清单5.1 现象屏幕上跳出「无法打开文件」现象很直接程序一运行就打印你写的那句错误提示然后退出。原因按出现频率排一下路径里的文件夹不存在、文件名拼错、用了r模式但文件还没被创建、程序没有该目录的写权限。还有一种容易被忽略的情况路径里包含了中文或者空格某些环境下处理起来会出问题。解决办法是分层排查。先把路径换成绝对路径确认是不是位置问题再检查模式只读模式下文件必须已存在然后看文件名有没有多打一个空格最后确认目标文件夹是不是只读。用相对路径时先打印一下当前工作目录确认程序到底站在哪儿找文件。5.2 现象文件生成了但内容是空的或者只有一半程序打印了「写入完成」打开文件一看空的或者只写进去前半截。最常见的原因是没调用fclose。写操作先进缓冲区缓冲区满了或者关闭文件时才真正写进硬盘。程序在关闭之前崩溃、被强制结束缓冲区里的内容就丢了。另一个原因是return提前执行跳过了关闭那行。解决办法是把fclose当成写操作的固定收尾跟fopen成对出现。习惯上我会在写完fopen那一行之后立刻把fclose也敲上去中间再填内容这样就不会忘。5.3 现象读出来的中文变成一堆乱码英文和数字正常中文全是问号或者奇怪的符号。原因出在编码上。文件在硬盘上是一串字节怎么解释这串字节取决于编码方式。源码文件、终端、文本编辑器三方的编码不一致中文就会显示错乱。解决办法是统一编码。新建源码文件时选 UTF-8编辑器保存时也选 UTF-8终端如果能设置编码也设成一致。实在排查不出来先用纯英文内容验证读写逻辑是否正确逻辑没问题再回头收拾编码别把两个问题搅在一起查。5.4 现象改完代码重新运行结果还是老样子明明改了写入的内容跑出来还是旧的明明加了新的一行输出屏幕上根本看不到。原因通常有两个。一是编译没成功但你没注意运行的还是上一次生成的可执行文件。二是用了追加模式a新内容加在旧内容后面你打开文件只看了开头以为没变。解决办法是每次改完代码重新编译留意编译器有没有报错或者警告。用追加模式时打开文件先拉到最底下看一眼。另外养成一个习惯调试阶段先用w模式每次都是干净的新文件确认逻辑对了再换成a。5.5 现象程序跑完窗口一闪就没了什么都没看清双击运行黑框闪一下消失输出内容一个字都没读到。原因是程序执行完return 0就直接退出了控制台窗口跟着关闭。这跟文件读写本身没关系但新手在这个阶段特别容易撞上误以为是程序崩了。解决办法是在return 0;前面加一句等待输入的代码让程序停一下printf(按回车键退出...); getchar(); // 等一个回车窗口就不会立刻关掉更稳妥的方式是别双击运行改用命令行执行。窗口是命令行提供的程序结束窗口也不会消失输出内容完整留在屏幕上。6. 读写跑通之后下一步练什么、按什么顺序练文本文件的读写跑通只是把门推开了。接下来往哪走我建议按「数据形态」这条线来不要东一榔头西一棒子。第一步把单行读写练熟。做一个命令行待办清单启动时从todo.txt读全部内容到数组用户输入新条目就追加一行输入list就把数组打印出来。这个练习把fopen、fgets、fprintf、fclose全用上了还顺带练了数组和循环性价比很高。第二步学结构化的文本格式。把通讯录写成姓名,电话一行一条读进来之后用字符串处理函数按逗号切开存进结构体数组。这一步会逼你面对「怎么把一行文本变成一个结构体」是文件读写真正开始有用的时候。第三步接触定位和二进制。文本读完就完了二进制文件可以跳着读。fseek移动读写位置ftell告诉你当前位置配合fread、fwrite就能把整个结构体数组一次性存盘、一次性读回。到这一步你会发现之前一行行处理的麻烦事换成二进制几行代码就解决了。阶段练什么用到的函数大概花多久第一阶单行文本读写、追加fopenfgetsfprintffclose一两天第二阶一行多字段、拆分成结构体字符串处理加文件读写三四天第三阶随机定位、二进制存取fseekftellfreadfwrite一周左右练习顺序上有个坑我踩过一开始就去啃二进制和随机定位代码能跑但完全不知道为什么这么写过两天全忘。后来改成先把文本文件用熟做出两个真正能用的小工具再回头看fseek一下子就通了。基础不牢的时候硬上高级特性属于自找麻烦。还有个小习惯值得从第一天就养起来每个练习都单独建文件夹源码和生成的数据文件放一起路径一律用相对路径。这样整个文件夹拷到别的机器上也能直接跑不会出现「在我这儿好好的」那种情况。从那以后我每次新建文件操作相关的练习都强制走一遍「建空文件夹、写源码、命令行编译、运行、打开生成的文件确认内容」这五步一步不省。很多看起来玄学的问题其实都藏在这五步里没做到位的地方。希望这些能帮你少绕几个弯先从把两行字写进文件开始。本文还有配套的精品资源点击获取