C 库函数 – fread()（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 C 语言编程中，文件操作是一项基础且重要的技能。无论是处理文本数据、二进制文件，还是进行复杂的数据交换，都需要依赖标准库提供的函数。其中，fread() 函数作为 C 标准库的核心成员，是读取文件内容的高效工具。本文将从零开始讲解 fread() 的语法、使用场景、常见问题及进阶技巧，帮助开发者系统性地掌握这一功能，并通过实际案例加深理解。

什么是 fread()？

fread() 是 C 标准库中用于从文件中读取数据的函数，它支持一次性读取大量数据，适用于二进制文件和文本文件的读取。可以将其想象为一个“搬运工”：它会从文件中“搬运”指定数量的数据块到程序内存中的目标地址。

函数原型与参数解析

fread() 的函数原型如下：

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

• 参数解释：
  | 参数名 | 作用描述 |
  |-------------|--------------------------------------------------------------------------|
  | ptr | 指向内存目标地址的指针，用于存储读取的数据。 |
  | size | 每个数据项的字节大小（例如：字符是 1 字节，整数可能是 4 字节）。 |
  | nmemb | 要读取的数据项数量。 |
  | stream | 文件指针，指向已打开的文件。 |

• 返回值：成功时返回实际读取的数据项数量（小于或等于 nmemb），失败时返回 0。

形象比喻：

• size 是每个包裹的大小，nmemb 是包裹的数量，ptr 是存放包裹的仓库地址，stream 是快递员手中的包裹来源。fread() 就像一个搬运工，根据包裹大小和数量，把包裹从快递员那里搬到仓库中。

如何正确使用 fread()？

场景一：读取文本文件

当需要读取文本文件时，fread() 可以高效地一次性读取整块数据。例如，读取一个纯文本文件并输出其内容：

#include <stdio.h>  

int main() {  
    FILE *file = fopen("example.txt", "r");  
    if (file == NULL) {  
        perror("Failed to open file");  
        return 1;  
    }  

    // 分配内存空间，假设文件最大 1KB  
    char buffer[1024];  
    size_t bytes_read = fread(buffer, 1, sizeof(buffer), file);  

    // 输出读取的内容  
    printf("Read %zu bytes: %.*s\n", bytes_read, (int)bytes_read, buffer);  

    fclose(file);  
    return 0;  
}  

关键点说明：

• fopen() 必须以读模式（如 "r" 或 "rb"）打开文件。
• buffer 需要足够大以容纳文件内容，否则会导致数据截断。
• fread() 的第三个参数 1 表示每个字符占 1 字节，nmemb 是缓冲区大小。

场景二：读取二进制文件

对于二进制文件（如图片、音频），fread() 的优势更加明显。例如，读取一个二进制文件并统计其大小：

#include <stdio.h>  

int main() {  
    FILE *file = fopen("image.jpg", "rb");  
    if (file == NULL) {  
        perror("Failed to open file");  
        return 1;  
    }  

    // 获取文件大小  
    fseek(file, 0, SEEK_END);  
    size_t file_size = ftell(file);  
    rewind(file);  

    // 分配动态内存  
    unsigned char *buffer = (unsigned char *)malloc(file_size);  
    if (buffer == NULL) {  
        perror("Memory allocation failed");  
        fclose(file);  
        return 1;  
    }  

    // 读取整个文件  
    size_t read_size = fread(buffer, 1, file_size, file);  
    printf("File size: %zu bytes, Read: %zu bytes\n", file_size, read_size);  

    free(buffer);  
    fclose(file);  
    return 0;  
}  

关键点说明：

• 使用 "rb" 模式打开文件以确保二进制模式。
• 通过 fseek() 和 ftell() 可以快速获取文件大小。
• 动态内存分配需注意释放内存，避免内存泄漏。

场景三：读取结构体数据

fread() 也常用于读取自定义结构体的数据。例如，读取包含姓名和年龄的结构体：

#include <stdio.h>  

typedef struct {  
    char name[50];  
    int age;  
} Person;  

int main() {  
    FILE *file = fopen("people.dat", "rb");  
    if (file == NULL) {  
        perror("Failed to open file");  
        return 1;  
    }  

    Person person;  
    size_t items_read = fread(&person, sizeof(Person), 1, file);  
    if (items_read == 1) {  
        printf("Name: %s, Age: %d\n", person.name, person.age);  
    } else {  
        printf("Read failed.\n");  
    }  

    fclose(file);  
    return 0;  
}  

关键点说明：

• sizeof(Person) 确保读取整个结构体的字节大小。
• 读取前需保证文件中结构体的排列与程序定义一致，否则可能导致数据错位。

常见问题与解决方案

问题一：读取失败或数据不完整

原因：

1. 文件未正确打开（路径错误、权限不足）。
2. 文件指针未指向正确的位置（如未重置到文件开头）。
3. 内存缓冲区不足。

解决方案：

• 检查 fopen() 的返回值是否为 NULL。
• 使用 fseek(file, 0, SEEK_SET) 将指针重置到文件开头。
• 计算缓冲区大小时，确保足够容纳文件内容。

问题二：如何检测文件结束？

fread() 读到文件末尾时会停止，但无法直接判断是否读取到末尾。可以通过以下方法检测：

if (feof(file)) {  
    printf("Reached end of file.\n");  
}  

进阶技巧

技巧一：分块读取大文件

对于超大文件（如 GB 级），一次性读取可能导致内存不足。此时可以分块读取：

#define BUFFER_SIZE 4096  

// ...  

unsigned char buffer[BUFFER_SIZE];  
size_t total_read = 0;  
while ((bytes = fread(buffer, 1, BUFFER_SIZE, file)) > 0) {  
    total_read += bytes;  
    // 处理 buffer 中的数据  
}  

技巧二：结合 fseek 实现随机读取

通过 fseek() 可以跳转到文件的任意位置，再用 fread() 读取特定区域：

// 跳转到第 100 字节的位置  
fseek(file, 100, SEEK_SET);  
fread(buffer, 1, 10, file);  // 读取接下来的 10 字节  

完整案例分析

案例：读取二进制图片并统计颜色信息

假设有一个 BMP 图片文件，我们希望统计其 RGB 像素值的平均值：

#include <stdio.h>  
#include <stdlib.h>  

typedef struct {  
    unsigned char r, g, b;  
} Pixel;  

int main() {  
    FILE *file = fopen("image.bmp", "rb");  
    if (file == NULL) {  
        perror("Failed to open file");  
        return 1;  
    }  

    // 跳过 BMP 文件头（假设已知头信息长度）  
    fseek(file, 54, SEEK_SET);  

    Pixel *pixels;  
    size_t pixel_count = 10000;  // 假设图片有 10000 像素  
    pixels = (Pixel *)malloc(pixel_count * sizeof(Pixel));  

    size_t read_count = fread(pixels, sizeof(Pixel), pixel_count, file);  
    if (read_count != pixel_count) {  
        printf("Read incomplete.\n");  
    }  

    // 计算平均颜色值  
    unsigned int total_r = 0, total_g = 0, total_b = 0;  
    for (size_t i = 0; i < read_count; ++i) {  
        total_r += pixels[i].r;  
        total_g += pixels[i].g;  
        total_b += pixels[i].b;  
    }  

    printf("Average: R=%.2f G=%.2f B=%.2f\n",  
           (double)total_r / read_count,  
           (double)total_g / read_count,  
           (double)total_b / read_count);  

    free(pixels);  
    fclose(file);  
    return 0;  
}  

关键点：

• BMP 文件头通常为 54 字节，需跳过后再读取像素数据。
• 像素数据以 struct 形式存储，确保字节对齐。

结论

通过本文的学习，开发者可以掌握 fread() 函数的核心用法，包括文本、二进制文件及结构体的读取方法。需要注意的是，fread() 虽然高效，但需结合文件指针管理、内存分配及错误处理才能确保程序的健壮性。建议在实际开发中，先通过 fopen() 检查文件是否成功打开，并合理设计缓冲区大小。

对于希望深入学习的开发者，可以进一步探索 fwrite()（文件写入）、fscanf()（格式化读取）等函数，结合 fseek() 实现更复杂的文件操作。实践是掌握这些技能的最佳途径，建议通过编写小型项目（如文件复制工具、二进制数据分析器）来巩固所学知识。

掌握 C 库函数 – fread() 将为处理文件操作奠定坚实的基础，无论是开发工具、游戏引擎，还是系统级编程，它都是不可或缺的工具之一。