C 语言文件 IO 学习Day03：从基础函数到实战踩坑（BMP 读取 + 词典查询）

本文为 C 语言软件编程学习 Day03 笔记，系统梳理标准 IO 库函数、核心易混点对比，并结合「BMP 图片宽高读取」「英汉词典查询」两个实战项目，总结实操中高频踩坑点

文章目录

• 前言
• 一、文件 IO 核心函数全解
  • 1. fgetc：读取单个字符
  • 2. fputs：写入字符串
  • 3. fgets：读取一行字符串
  • 4. fprintf：格式化写入文件
  • 5. fwrite：整块数据写入
  • 6. fread：整块数据读取
  • 7. fseek：设置文件偏移位置
  • 8. ftell：获取当前偏移量
  • 9. rewind：回到文件开头
• 二、易混函数深度对比
  • 1. gets 与 fgets 核心区别
  • 2. puts 与 fputs 核心区别
• 三、实战项目与踩坑复盘
  • 项目 1：读取 24 位 BMP 图片的宽度和高度
  • 项目 2：英汉词典查询系统
• 四、高频易错点速查表
• 五、课后练习：文件拷贝

前言

第三天的学习核心围绕标准文件 IO 操作展开，从单字符读写到整块数据读写，再到文件位置偏移控制，最终落地到两个实战场景。这部分知识点函数多、细节碎，坑点密集，尤其字符串与指针结合的地方非常容易出错。本文按「函数大全 → 易混对比 → 实战项目 → 易错汇总」的结构整理，方便复习和避坑。

---

一、文件 IO 核心函数全解

1. fgetc：读取单个字符

int fgetc(FILE *stream);

• 功能：从文件流中读取一个字符
• 返回值：成功返回字符的 ASCII 码值；失败或读到文件末尾返回EOF
• 注意：返回值用int接收而不是char，因为EOF是超出 char 范围的负值

2. fputs：写入字符串

int fputs(const char *s, FILE *stream);

• 功能：将字符串写入指定文件流
• 返回值：成功返回非负整数；失败返回EOF
• 特点：不会自动追加换行符\n，原样输出字符串内容

3. fgets：读取一行字符串

char *fgets(char *s, int size, FILE *stream);

• 功能：从流中读取一行字符串，最多读取size-1个字符，末尾自动补\0
• 返回值：成功返回缓冲区首地址；失败或读到文件末尾返回NULL
• 核心特点：
  • 自带长度保护，不会缓冲区溢出
  • 会保留行尾的换行符\n，不会自动丢弃
  • 既可读取标准输入stdin，也可读取普通文件

4. fprintf：格式化写入文件

int fprintf(FILE *stream, const char *format, ...);

• 功能：按格式化字符串将数据写入指定文件流
• 返回值：成功返回实际写入的字符个数；失败返回负数
• 对比：printf等价于fprintf(stdin, ...)，只是默认输出到终端

5. fwrite：整块数据写入

size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);

• 功能：向文件写入nmemb个对象，每个对象占size字节
• 参数：
  • ptr：待写入数据的内存首地址
  • size：单个对象的字节大小
  • nmemb：要写入的对象数量
• 返回值：成功返回实际写入的完整对象个数；失败返回 0

6. fread：整块数据读取

size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream);

• 功能：从文件中读取nmemb个对象，每个对象占size字节，存入 ptr 指向的内存
• 返回值：成功返回实际读到的完整对象个数；失败或读到文件末尾返回 0
• 两种常用写法：
  • 读单个结构体 / 整数：fread(&var, sizeof(var), 1, fp)→ 返回值判断是否等于 1
  • 读字节缓冲区：fread(buf, 1, sizeof(buf), fp)→ 返回值就是读到的字节数

7. fseek：设置文件偏移位置

int fseek(FILE *stream, long offset, int whence);

• 功能：重新定位文件读写光标的位置
• 基准参数 whence：
  • SEEK_SET：从文件开头计算偏移
  • SEEK_CUR：从当前光标位置计算偏移
  • SEEK_END：从文件末尾计算偏移
• 返回值：成功返回 0；失败返回 - 1

8. ftell：获取当前偏移量

long ftell(FILE *stream);

• 功能：获取当前光标距离文件开头的字节偏移量
• 经典用法：配合 fseek 获取文件总大小

  fseek(fp, 0, SEEK_END); long file_size = ftell(fp);

9. rewind：回到文件开头

void rewind(FILE *stream);

• 功能：将文件光标直接重置到文件开头
• 等价于：fseek(fp, 0, SEEK_SET);

---

二、易混函数深度对比

1. gets 与 fgets 核心区别

这是考试最高频考点，也是实操最容易踩坑的点。

表格

对比维度	gets()	fgets()
缓冲区长度	无长度检查，输入多长写多长	强制指定 size，最多读 size-1 个字符
溢出风险	极高，C11 标准已正式删除	安全，不会越界
换行符处理	读到换行直接丢弃，替换为\0	换行符保留在字符串中，再补\0
读取来源	只能从标准输入读取	可从任意文件流读取
推荐程度	禁止使用	标准推荐写法

踩坑提醒：用fgets从键盘读取单词后，直接和文件内单词做strcmp会永远失败，因为字符串末尾多了一个\n。必须先清除换行符：

str[strcspn(str, "\n")] = '\0';

2. puts 与 fputs 核心区别

表格

对比维度	puts()	fputs()
换行符	自动在末尾追加一个\n	不会额外添加任何字符，原样输出
输出目标	只能输出到标准输出	可输出到任意文件流

---

三、实战项目与踩坑复盘

项目 1：读取 24 位 BMP 图片的宽度和高度

需求

从 BMP 文件中读取图片分辨率，已知宽度在文件偏移 18 字节处，占 4 字节；高度在偏移 22 字节处，占 4 字节。

核心代码

#include <stdio.h> int main(void) { FILE *fp = fopen("src.bmp", "rb"); // 二进制文件必须用rb打开！ if (NULL == fp) { perror("fopen failed"); return -1; } unsigned int width = 0, height = 0; fseek(fp, 18, SEEK_SET); // 定位到宽度字段 fread(&width, 4, 1, fp); fread(&height, 4, 1, fp); // 读完宽度光标自动后移4字节，正好对准高度 printf("宽度：%u\n高度：%u\n", width, height); fclose(fp); return 0; }

高频踩坑点

1. 偏移计算错误：误以为宽度从 17 字节开始

   正确逻辑：文件头占 14 字节（0-13）+ biSize 占 4 字节（14-17）= 18，宽度从 18 号字节开始。字段占 N 字节，下一字段起始位置 = 起始偏移 + N。

2. 用文本模式打开二进制文件：BMP 是二进制文件，必须用rb模式，否则数据会错乱。
3. 小端序问题：BMP 采用小端存储，x86/x64CPU 原生小端，直接 fread 到 int 变量即可，无需手动翻转字节。

---

项目 2：英汉词典查询系统

需求

终端输入单词，从词典文件（每行格式：单词 释义，释义内部含空格）中匹配并打印对应释义。

正确实现（strtok + 指针遍历）

#include <stdio.h> #include <string.h> int main(void) { FILE *fp = fopen("dict.txt", "r"); if (NULL == fp) { perror("fopen failed"); return -1; } char str[100] = {0}; char tmpbuff[4096] = {0}; gets(str); // 仅作业演示使用，实际开发禁用gets while (fgets(tmpbuff, sizeof(tmpbuff), fp) != NULL) { // 第一步：strtok只调用一次，切出第一个单词 char *word = strtok(tmpbuff, " "); if (word == NULL) continue; // 第二步：遍历指针越过单词末尾的\0，找到释义区域 char *meaning = word; while (*meaning != '\0') meaning++; // 走到单词结尾 meaning++; // 跨过strtok写入的\0 // 第三步：跳过释义开头连续的空格 while (*meaning != '\0' && *meaning == ' ') { meaning++; } // 第四步：字符串比较必须用strcmp if (strcmp(str, word) == 0) { printf("含义为：%s", meaning); break; } } fclose(fp); return 0; }

踩坑大汇总

1. 低级错误：文件名加双引号

   fopen("argv[1]", "r"); // ❌ 去找名叫argv[1]的文件，永远打开失败 fopen(argv[1], "r"); // ✅ 正确，访问命令行参数

2. 致命错误：用==比较字符串

   ==比较的是指针地址，不是字符串内容。内容比较必须用strcmp，相等返回 0。

3. 经典错误：多次调用 strtok 切碎释义

   strtok(NULL, " ")会把释义内部的空格也当分隔符切开，只能拿到半截释义。正确做法是只调用一次 strtok 切单词，剩余内容靠指针遍历获取。

4. 隐形错误：fgets 带换行符

   输入单词和词典行尾都可能带\n，不处理会导致 strcmp 永远匹配失败。

---

四、高频易错点速查表

易错点	错误写法	正确写法
字符串比较	if(str1 == str2)	if(strcmp(str1, str2) == 0)
命令行参数传文件名	fopen("argv[1]","r")	fopen(argv[1],"r")
二进制文件打开	fopen("a.bmp","r")	fopen("a.bmp","rb")
gets 安全问题	gets(str)	fgets(str, sizeof(str), stdin)
fgets 换行符	直接拿去 strcmp	先str[strcspn(str,"\n")]='\0'
strtok 切释义	strtok(NULL, " ")	只切一次单词，剩余内容指针遍历
BMP 偏移计算	宽度偏移 17	宽度偏移 18
ftell 返回值	%d打印	%ld打印（long 类型）
指针遍历边界	先判断字符再判断 \0	先判断!='\0'再判断字符，利用短路保护

---

五、课后练习：文件拷贝

利用fread和fwrite实现二进制文件拷贝（图片、文档均可），核心框架：

#include <stdio.h> int main(int argc, char *argv[]) { if (argc < 3) { printf("usage: ./a.out src_file dst_file\n"); return -1; } FILE *fp_src = fopen(argv[1], "rb"); FILE *fp_dst = fopen(argv[2], "wb"); char buf[4096] = {0}; size_t n = 0; while ((n = fread(buf, 1, sizeof(buf), fp_src)) > 0) { fwrite(buf, 1, n, fp_dst); } fclose(fp_src); fclose(fp_dst); return 0; }