19、标准流重定向：freopen函数、重定向stdin/stdout/stderr、日志重定向技巧

标准流重定向，说白了就是让程序“换一个地方”读写数据。

默认情况下，printf往屏幕打印，scanf从键盘读取。但嵌入式环境里，很多时候没有屏幕、没有键盘——只有串口、文件、或者网络缓冲区。这时候，重定向就派上用场了。

我最早接触这个功能，是在调试一个跑在ARM Cortex-M3上的裸机程序。板子没有显示屏，printf的内容全丢进了“黑洞”。后来用freopen把stdout重定向到UART，才终于看到了调试信息。嗯，那一刻的感觉，就像瞎子突然睁开了眼。

19.1 freopen函数：标准流重定向的核心

freopen是标准C库提供的函数，原型在里：

FILE *freopen(const char *filename, const char *mode, FILE *stream);

它做的事情很简单：关闭stream当前关联的文件，然后重新打开filename，并把这个新文件绑定到stream上。

三个参数的含义：

• filename：要打开的文件名。传NULL在某些实现里是未定义行为，我建议永远不要这么干。
• mode：打开模式，和fopen一样，比如"r"、"w"、"a"。
• stream：要重定向的标准流，可以是stdin、stdout、stderr。

返回值：成功返回传入的stream指针，失败返回NULL。

19.2 重定向stdin：从文件读取输入

调试时，如果每次都要手动敲一堆测试数据，你会疯掉的。我习惯把测试用例写在文件里，然后重定向stdin：

#include <stdio.h>

int main() {
    int a, b;
    
    // 将标准输入重定向到文件
    if (freopen("input.txt", "r", stdin) == NULL) {
        perror("freopen stdin failed");
        return 1;
    }
    
    // 现在scanf从input.txt读取，而不是键盘
    while (scanf("%d %d", &a, &b) == 2) {
        printf("%d + %d = %d\n", a, b, a + b);
    }
    
    return 0;
}

这样做的好处是：测试数据可复现、可版本管理。我在项目中经常用这个技巧来做自动化回归测试。

19.3 重定向stdout：输出到文件

把打印信息保存到文件，而不是显示在屏幕上，这在很多场景下非常有用：

• 程序运行日志需要持久化保存
• 嵌入式设备没有显示终端
• 需要对比两次运行的结果差异

#include <stdio.h>

int main() {
    // 将标准输出重定向到文件
    if (freopen("output.log", "w", stdout) == NULL) {
        perror("freopen stdout failed");
        return 1;
    }
    
    // 这些printf不会显示在屏幕上，而是写入output.log
    printf("程序启动时间: 2024-01-01 10:00:00\n");
    printf("初始化完成\n");
    printf("开始处理数据...\n");
    
    return 0;
}

你想想看，如果程序跑在无人值守的服务器上，没有重定向，你连它什么时候崩溃的都不知道。

19.4 重定向stderr：错误信息独立输出

我个人非常看重stderr的重定向。为什么？因为stdout和stderr分开，可以做到“正常日志存文件，错误信息实时看”：

#include <stdio.h>

int main() {
    // stdout重定向到日志文件
    freopen("app.log", "w", stdout);
    
    // stderr重定向到另一个文件，或者保留到终端
    // 这里演示重定向stderr到错误日志
    freopen("error.log", "w", stderr);
    
    printf("这是一条普通日志\n");
    fprintf(stderr, "警告：内存使用率超过80%%\n");
    fprintf(stderr, "错误：文件打开失败\n");
    
    return 0;
}

我曾经在一个数据采集项目中，把stdout定向到网络socket，stderr保留到本地文件。这样正常数据流走网络，错误信息留在本地便于排查。嗯，这个设计帮我快速定位了好几次网络闪断的问题。

19.5 日志重定向技巧：实战经验

光会用freopen还不够，实际项目中需要更灵活的策略。下面是我总结的几个实用技巧：

技巧1：同时输出到文件和终端

freopen只能重定向到一个地方。如果想“既打印到屏幕，又写入文件”，需要自己封装：

#include <stdio.h>
#include <stdarg.h>

void log_printf(const char *fmt, ...) {
    va_list args;
    FILE *log_file = fopen("app.log", "a");
    if (log_file == NULL) return;
    
    va_start(args, fmt);
    vfprintf(log_file, fmt, args);  // 写入文件
    vprintf(fmt, args);             // 打印到屏幕
    va_end(args);
    
    fclose(log_file);
}

技巧2：按日期滚动日志

日志文件不能无限增长。我习惯在程序启动时，根据当前日期生成日志文件名：

#include <stdio.h>
#include <time.h>

void init_log() {
    char filename[64];
    time_t now = time(NULL);
    struct tm *t = localtime(&now);
    
    snprintf(filename, sizeof(filename), 
             "log_%04d%02d%02d.txt",
             t->tm_year + 1900, 
             t->tm_mon + 1, 
             t->tm_mday);
    
    if (freopen(filename, "a", stdout) == NULL) {
        fprintf(stderr, "无法打开日志文件: %s\n", filename);
    }
}

技巧3：重定向到内存缓冲区（嵌入式常用）

在资源受限的嵌入式系统里，可能没有文件系统。这时候可以把stdout重定向到内存缓冲区，然后通过串口或网络批量发送：

#include <stdio.h>

static char log_buffer[4096];
static int buffer_pos = 0;

// 自定义写函数（需要配合平台相关代码）
static int my_stdout_write(void) {
    // 将log_buffer内容通过UART发送
    // 然后清空缓冲区
    buffer_pos = 0;
    return 0;
}

// 使用setbuf或setvbuf将stdout关联到自定义缓冲区
// 注意：这需要底层支持，不同平台实现不同

19.6 知识体系图

下面这张图总结了标准流重定向的核心脉络：

19.7 避坑指南

最后，分享几个我踩过的坑：

• 不要重定向后忘记恢复：如果程序里调用了第三方库，库函数可能也用了printf。你重定向stdout后，库的打印也会跟着走。我曾经因为这个，把库的调试信息全写进了我的数据文件，导致解析失败。
• 多线程环境要小心：freopen不是线程安全的。如果多个线程同时操作标准流，会出现竞争。建议在程序初始化阶段一次性完成重定向，之后不再改动。
• 嵌入式平台可能不支持：有些轻量级的C运行库（比如Newlib的某些配置）可能没有完整实现freopen。用之前先确认一下文档。
• 文件权限问题：在Linux下，如果程序以普通用户运行，而日志文件所在目录没有写权限，freopen会静默失败。记得检查返回值。

标准流重定向，说白了就是给程序的输入输出“换管道”。用好了，调试效率翻倍；用不好，数据混乱到想砸键盘。希望这些经验能帮你少走弯路。

---

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