std::streambuf派生类必须重载underflow()（输入）或overflow(int)（输出）才能使流可用；双向流还需seekoff()和seekpos()；生命周期须确保缓冲区≥流对象，推荐unique_ptr管理；缓冲区大小建议4kb~64kb；吞吐敏感场景必须重载sgetn()/sputn()并正确维护指针。
std::streambuf 派生类必须重载哪些函数才能让流可用
光继承 std::streambuf 不会自动让 std::istream 或 std::ostream 工作——流对象依赖底层缓冲区的几个关键虚函数返回有效指针或处理字节。最常漏掉的是 underflow()（输入）和 overflow()（输出），这两个不实现，读写直接失败或卡死。
实际使用中，只要支持单向操作，就只重载对应函数：
- 只读流：必须实现 underflow()，可选实现 showmanyc() 提升效率
- 只写流：必须实现 overflow(int)，sputn() 是性能优化项，非必需但强烈建议
- 双向流：还需注意 seekoff() 和 seekpos()，否则 seekg()/seekp() 报 failure
典型错误现象：std::cin >> x 无响应、os 不输出、<code>is.peek() 返回 EOF 即使缓冲区有数据——大概率是 underflow() 没正确更新 gptr()/egptr()，或 overflow() 忘了返回传入的 c。
如何避免派生 streambuf 的生命周期导致流失效
std::iostream 构造时绑定 std::streambuf*，但它不管理该指针内存。常见坑是把派生类对象作为局部变量传进去：
void bad_example() {
MyStreamBuf buf; // 栈上对象
std::ostream os(&buf); // os 持有悬垂指针
} // buf 析构 → os 后续所有操作 UB
正确做法只有两种：
- 缓冲区对象生命周期 ≥ 流对象：全局/静态变量、堆分配（用智能指针托管）
- 在流对象作用域内严格控制缓冲区生存期，例如封装成 RAII 类，构造时 new，析构时 delete（不推荐裸 new）
- 更安全的是用 std::unique_ptr<mystreambuf></mystreambuf> 管理，并在流构造后用 rdbuf() 替换（注意旧 buffer 需手动清理）
另一个隐形问题：多个流共享同一 streambuf 实例。这本身合法，但若缓冲区内部有状态（如读写位置、临时缓冲区），必须加锁或明确文档化“非线程安全”——否则多线程下 read 和 write 互相踩内存。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
自定义 streambuf 中的缓冲区大小与同步时机怎么调
std::streambuf 默认不分配缓冲区，setg()/setp() 手动设置指针范围。缓冲区大小不是越大越好：
- 输入缓冲太小（如仅 1 字节）：频繁调 underflow()，性能崩塌
- 输出缓冲太大（如 1MB）：延迟高，实时日志或网络流无法及时 flush
- 建议值：4KB~64KB，匹配系统页大小或目标 IO 设备典型块大小
同步行为由两个机制控制：
- std::ios_base::sync_with_stdio(false)：禁用 C stdio 同步，提升速度，但禁止混用 printf 和 <br>
- <code>std::unitbuf flag：每次输出后自动 flush()，适合调试；但会抵消缓冲优势，慎用
- 更可控的是显式调 os.flush() 或重载 sync() 虚函数，在其中做真正 IO 提交（比如 send() 到 socket）
注意：sync() 被调用不等于数据已落盘/发网——它只表示“缓冲区已清空”，具体是否完成传输，得看你的实现里有没有等 ACK 或调 fsync()。
为什么 operator> 看似正常但数据错乱
根本原因：流运算符底层依赖 xsgetn() / xsputn()，而这两个函数默认委托给 sgetn() / sputn()，再进一步调用多次 sbumpc() / sputc()。如果你只重载了 underflow() 却没重载 sgetn()，标准库就会用慢速逐字节方式读——不仅性能差，还可能因指针移动逻辑不一致导致跳字节或重复读。
实操建议：
- 对吞吐敏感场景（如文件解包、网络协议解析），必须重载 sgetn() 和 sputn()，批量搬运内存
- 重载时务必检查请求长度是否超出当前可用缓冲区（egptr() - gptr()），不足则先调 underflow() 填充
- 返回值必须是实际搬运字节数，不能硬写 n；返回 0 表示 EOF，负值表示错误
- 若缓冲区是环形或异步填充的，sgetn() 内部需处理跨边界拷贝，别直接 memcpy
最容易被忽略的点：派生类里修改了 gptr()/pptr() 等指针后，没同步更新 eback()/epptr()，导致后续 sgetn() 计算可用长度出错——这种 bug 表现为偶发性丢数据，极难复现。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
