24、标准输入输出缓冲区：setbuf、fflush 的作用

缓冲区这个话题，说实话，很多C语言开发者写了三五年代码都没真正搞明白。我记得刚入行那会儿，有个同事调试串口程序，数据死活发不出去，折腾了两天，最后发现就是缓冲区没刷新的问题。嗯，今天我们就来把这个东西彻底讲清楚。

什么是标准I/O缓冲区？

标准I/O库（stdio.h）为了提高效率，不会每次读写都直接调用系统调用。它会先把数据攒到一块内存里，等攒够了再一次性交给操作系统。这块内存，就是缓冲区。

说白了，缓冲区就是个“中转站”。你想想看，如果每次写一个字符都去调用一次write()系统调用，那效率得多低？系统调用是有开销的，频繁调用会严重影响性能。

我做过一个嵌入式项目，需要在LCD上实时显示传感器数据。当时用printf打印，发现数据更新有延迟。查了半天，原来是stdout被重定向到了文件，变成了全缓冲模式。这就是典型的缓冲区问题。

setbuf：手动设置缓冲区

setbuf函数可以让我们自己控制缓冲区的行为。它的原型很简单：

void setbuf(FILE *stream, char *buf);

参数说明：

• stream：文件流指针
• buf：缓冲区指针。传NULL表示无缓冲，传自定义缓冲区则使用该缓冲区

这里有个坑，我必须要提醒你：

来看个实际例子：

#include <stdio.h>

int main() {
    char buf[BUFSIZ];
    
    // 设置stdout为全缓冲，使用自定义缓冲区
    setbuf(stdout, buf);
    
    printf("这条消息不会立即显示\n");
    printf("它被缓存起来了\n");
    
    // 手动刷新
    fflush(stdout);
    
    // 设置为无缓冲
    setbuf(stdout, NULL);
    printf("这条消息会立即显示\n");
    
    return 0;
}

运行这段代码，你会发现前两条printf不会立即输出，直到fflush调用后才一起显示。第三条printf因为设置了无缓冲，会立即输出。

fflush：强制刷新缓冲区

fflush的作用很简单：把缓冲区里积压的数据强制写入目标设备。原型：

int fflush(FILE *stream);

参数传NULL表示刷新所有输出流。返回值：成功返回0，失败返回EOF。

我个人习惯在以下场景使用fflush：

• 调试时，确保printf立即输出
• 写日志文件时，防止程序崩溃丢失数据
• 嵌入式开发中，串口通信前确保数据已发送

setbuf(stdout, NULL);  // 让printf立即输出

缓冲区与文件操作的关系

这里有个容易混淆的点：标准I/O缓冲区和内核缓冲区是两个不同的概念。标准I/O库有自己的用户态缓冲区，内核也有自己的页缓存。fflush只刷新用户态缓冲区，不保证数据已经写入磁盘。

如果要确保数据真正写入磁盘，需要调用fsync或sync。我在做数据采集系统时就吃过这个亏——以为fflush就万事大吉了，结果突然断电，最后几秒的数据全丢了。

常见陷阱与避坑指南

我曾经在项目中遇到过这样一个问题：

// 错误示例
FILE *fp = fopen("data.txt", "w");
setbuf(fp, NULL);  // 设置无缓冲
fprintf(fp, "hello");
fclose(fp);

这段代码看起来没问题，但如果你在setbuf之前做了其他操作（比如先fprintf了一次），那setbuf就失效了。正确的做法是：

// 正确做法
FILE *fp = fopen("data.txt", "w");
setbuf(fp, NULL);  // 必须在任何I/O操作之前
fprintf(fp, "hello");
fclose(fp);

还有一个常见的坑：

• 不要使用局部数组作为setbuf的缓冲区，函数返回后缓冲区就失效了
• 多线程环境下，fflush不是线程安全的，需要加锁
• setbuf的缓冲区大小至少为BUFSIZ（通常是8192字节）

缓冲区机制流程图

下面这张图展示了标准I/O缓冲区的完整工作流程：

实际应用场景

在嵌入式开发中，缓冲区管理尤其重要。我做过一个项目，MCU通过UART与PC通信，波特率只有9600。如果不用缓冲区，每次发送一个字节都要等UART发送完成，CPU就被占死了。用了缓冲区后，数据先攒到内存里，等缓冲区满了或者遇到换行符再一次性发送，CPU利用率从80%降到了15%。

但缓冲区也带来了问题：如果程序突然崩溃，缓冲区里的数据就丢了。所以在关键数据写入后，我习惯调用fflush确保数据已经送出。

嗯，关于缓冲区就讲这么多。这东西看似简单，但用不好真的会出大问题。我见过太多因为缓冲区没刷新导致的诡异bug了。希望今天的讲解能帮你避开这些坑。

公众号:蓝海资料掘金营，微信deep3321