直接用 std::cout.rdbuf() 替换为自定义 streambuf 是唯一可靠、无副作用的捕获方式；freopen/dup2 等系统级重定向会污染进程 stdout，导致第三方库输出错乱、多线程冲突、异常后不可恢复、跨平台不兼容及缓冲不同步。
直接用 std::cout.rdbuf() 替换为自定义 streambuf 是唯一可靠、无副作用的捕获方式；所有基于 freopen、dup2 或全局重定向的方案，在多线程、异常路径或第三方库调用时极易失效。
为什么不能用 freopen("/dev/null", "w", stdout) 或 dup2
这类系统级重定向会污染整个进程的 stdout，导致：
– 第三方库（如 OpenCV、glog）输出消失或错乱
– 多线程中其他线程的 cout 被意外截断
– 异常抛出后未恢复句柄，后续输出不可控
– Windows 下 /dev/null 不存在，NUL 又不完全等价
– std::cout 内部缓冲区与 C stdio 缓冲可能不同步，出现漏捕
如何安全替换 cout 的 streambuf
核心是继承 std::streambuf 并重写 overflow() 和 sputn()，再用 cout.rdbuf() 切换。关键点：
-
overflow(int c)处理单字符写入（如cout ），返回 <code>c表示接受，EOF表示拒绝 -
sputn(const char* s, std::streamsize n)处理批量写入（如字符串、数字格式化后数据），必须返回实际写入字节数 - 缓存建议用
std::string+data()指针托管，避免频繁分配；不要在streambuf析构时清空内容——cout可能还在用它 - 切换前保存原
streambuf*，结束后务必恢复，否则后续cout行为未定义
示例精简骨架：
class capture_buf : public std::streambuf {
std::string buf_;
protected:
int_type overflow(int_type c) override {
if (c != EOF) buf_ += static_cast<char>(c);
return c;
}
std::streamsize sputn(const char* s, std::streamsize n) override {
buf_.append(s, static_cast<size_t>(n));
return n;
}
public:
const std::string& str() const { return buf_; }
void clear() { buf_.clear(); }
};
<p>// 使用：
capture_buf cap;
std::streambuf* old = std::cout.rdbuf(&cap);
std::cout </p></size_t></char>
捕获期间要注意的隐式行为
std::cout 默认带缓冲，且部分输出（尤其是含 \n 或 std::endl）会触发 flush()，而 flush() 会调用 pubsync() —— 若你没重写它，默认返回 -1，可能导致某些标准库实现静默丢弃剩余缓冲。因此：
- 显式重写
int pubsync() override { return 0; }（0 表示成功） - 避免依赖
std::endl触发捕获；改用"\n"+ 手动cout.flush() - 若需实时捕获（如日志流），在
overflow()中检查c == '\n'并做相应处理 - 注意 locale 和 facet：自定义
streambuf不影响格式化逻辑，数字/时间等仍按当前cout的imbue()设置转成字符串后再传入
真正难的不是写一个能收字符串的 streambuf，而是确保它在 longjmp、异常栈展开、RAII 提前退出、以及和 std::ios_base::sync_with_stdio(false) 共存时不崩溃——这些边界情况，往往只在压测或上线后暴露。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
