在C++程序开发中，控制台输出的调试信息、运行状态等内容往往仅能在程序运行时查看，一旦程序关闭就无法追溯。将标准输出流重定向到本地日志文件，同时启用系统缓冲减少IO开销，是留存运行记录、提升程序性能的常用方案。
标准输出流重定向的基本原理
C++的标准输出流std::cout默认关联到控制台的输出设备，我们可以通过修改其绑定的输出缓冲区，将其指向我们创建的日志文件缓冲区，从而实现输出的重定向。系统提供的freopen函数可以快速完成流的重定向操作，也可以手动操作缓冲区实现更灵活的控制。
系统缓冲的作用与开启方式
频繁向文件写入数据会产生较多的磁盘IO操作，影响程序运行效率。系统缓冲机制会先将输出内容暂存在内存缓冲区中，当缓冲区满或者程序主动刷新时，再一次性写入磁盘，大幅减少IO次数。在C++中，我们可以通过设置文件的缓冲模式来开启系统缓冲。
常用的缓冲模式
- 全缓冲：只有当缓冲区被填满时才进行实际的写入操作，适合日志文件场景
- 行缓冲：遇到换行符时就执行写入操作，适合控制台输出场景
- 无缓冲：每次输出都立即写入，适合错误日志等需要即时落盘的场景
完整实现代码示例
下面的代码演示了将标准输出流重定向到本地日志文件，并开启全缓冲的完整实现：
#include <iostream>
#include <cstdio>
#include <fstream>
int main() {
// 打开日志文件，以追加模式写入
std::ofstream logFile;
logFile.open("app_log.txt", std::ios::out | std::ios::app);
if (!logFile.is_open()) {
std::cerr << "无法打开日志文件" << std::endl;
return 1;
}
// 获取文件对应的C风格文件指针
FILE* cFile = logFile.rdbuf()->file();
if (cFile == nullptr) {
std::cerr << "获取文件指针失败" << std::endl;
return 1;
}
// 设置全缓冲，缓冲区大小为4096字节
char buffer[4096];
setvbuf(cFile, buffer, _IOFBF, sizeof(buffer));
// 将标准输出流重定向到日志文件
// 保存原来的标准输出流缓冲区，方便后续恢复
std::streambuf* originalCoutBuffer = std::cout.rdbuf();
std::cout.rdbuf(logFile.rdbuf());
// 测试输出内容，这些内容会被写入日志文件
std::cout << "程序启动，开始记录日志" << std::endl;
std::cout << "当前运行模块：用户登录模块" << std::endl;
std::cout << "用户ID：10001，登录成功" << std::endl;
// 手动刷新缓冲区，确保内容写入文件
std::cout.flush();
// 恢复标准输出流到控制台
std::cout.rdbuf(originalCoutBuffer);
// 关闭日志文件
logFile.close();
// 验证标准输出已恢复
std::cout << "日志已写入完成，标准输出已恢复到控制台" << std::endl;
return 0;
}
注意事项
- 重定向后如果需要恢复控制台输出，一定要提前保存原来的输出缓冲区指针，避免后续无法输出到控制台
- 设置缓冲区时，缓冲区的内存生命周期要长于文件的使用周期，避免缓冲区被释放后出现野指针问题
- 程序异常退出时，缓冲区中可能还有未写入的内容，可以在关键逻辑后主动调用
flush方法刷新缓冲区 - 日志文件路径如果使用相对路径，要注意程序运行的工作目录，避免文件写入到预期外的位置
如果需要同时重定向标准错误流std::cerr，可以用相同的方式操作std::cerr的缓冲区，实现错误日志和普通日志的分开记录。