如何通过cout.rdbuf()实现控制台输出重定向至文件流？

本文共计686个文字，预计阅读时间需要3分钟。

很多人上来就写 `cout.rdbuf(file_stream.rdbuf())`，结果发现输出乱码、部分丢失，甚至程序崩溃。根本原因是标准流对象（如 `cout`）内部的缓冲区和状态（如 `failbit`、`eofbit`）不会自动同步到新的缓冲区；更重要的是，如果 `file_stream` 是局部变量，它的 `rdbuf()` 在析构时失效，而 `cout` 还在用这个失效的缓冲区，这就是典型的 UAF（use-after-free）错误。

安全重定向的三步操作（C++11 及以上）

必须同时处理缓冲区切换、状态同步、生命周期绑定。推荐做法：

• 用 std::ofstream 声明为全局或静态变量（确保生存期长于 cout 使用期），或至少与重定向作用域同级
• 先保存原始缓冲区指针：auto old_buf = std::cout.rdbuf(file_stream.rdbuf())
• 重定向后手动刷新一次：std::cout ，避免旧缓冲区残留输出

示例：

std::ofstream log_file("output.txt"); auto old_buf = std::cout.rdbuf(log_file.rdbuf()); std::cout << "This goes to file\n"; std::cout << std::flush; // 关键：清空可能滞留在原缓冲区的 pending 数据 // ……后续使用 std::cout.rdbuf(old_buf); // 恢复前务必 flush 文件流本身 log_file.flush();

为什么不能只靠 freopen()？

虽然 freopen("output.txt", "w", stdout) 看似简单，但它只影响 C 风格的 printf 等函数，在 C++ 中对 cout 无效（除非你用 std::ios_base::sync_with_stdio(false) 关闭同步，但那会破坏 cin/cout 和 scanf/printf 的混用兼容性）。而且 freopen 是 C API，不参与 RAII，容易漏关文件或重复打开。

立即学习“C++免费学习笔记（深入）”；

重定向后 std::endl 和 \n 行为差异

重定向到文件流后，std::endl 仍会触发 flush，但代价是每次输出都强制刷盘，严重影响性能；而 \n 只换行，依赖缓冲区自动刷新或显式 flush。生产环境建议统一用 \n + 定期 log_file.flush()，避免 I/O 成为瓶颈。

真正麻烦的是恢复原输出时忘了 cout.rdbuf(old_buf)，或者恢复后没调用 std::cout.clear() —— 如果重定向期间文件写满或磁盘满，cout 可能已置 failbit，不 clear 就再也输出不了东西了。