c++oding="utf-8" ?>
setvbuf必须在fopen后、首次I/O前调用一次且不可重复；传nullptr时缓冲区大小向下取整为偶数，自定义缓冲区需确保生命周期覆盖FILE*整个存活期。
不能动态调整已打开流的缓冲区；setvbuf 只能在 fopen 后、首次 I/O 前调用一次，且不可重复生效。
setvbuf 必须在文件打开后、任何读写前调用
这是最常踩的坑：很多人试图在 fopen 之后做点别的（比如 fseek、fprintf、甚至只是 fflush），再调用 setvbuf —— 此时函数会静默失败，返回 -1 并设置 errno = EINVAL。
正确顺序只有这一种：
-
fopen("data.bin", "wb")→ 得到FILE* -
立刻调用
setvbuf(fp, nullptr, _IOFBF, 131072) - 之后才能用
fwrite、fputs、fflush等
Windows 和 Linux 下行为一致。glibc 和 MSVCRT 都严格检查流是否“干净”（即未进行过任何 I/O 操作）。
buffer 参数为 nullptr 时，libc 自动分配但有隐含规则
传 nullptr 看似省事，但要注意：
- 实际分配的缓冲区大小会被向下取整为偶数：比如传
size = 65535，libc 内部用的是65534 - 自动分配的内存由 libc 管理，生命周期与
FILE*绑定；fclose时自动释放 - 若你后续想换缓冲策略（比如从全缓冲切到无缓冲），做不到——只能关掉重开
示例：setvbuf(fp, nullptr, _IOLBF, 8192) 在 Linux 上实际分配 8192 字节（已是偶数），但在 Windows 上可能变成 8190。
自定义缓冲区（非 nullptr）必须保证生命周期足够长
当你传入自己的缓冲区指针（如 char buf[128 * 1024]），要确保：
- 该内存不能是函数栈上临时变量，且在其对应
FILE*被fclose前不能销毁 - 若用
std::vector，得用.data()+ 手动管理析构顺序，否则容易 UAF - 缓冲区地址必须按平台对齐（通常 16 字节对齐较安全；glibc 不强制，但某些嵌入式 libc 会检查）
错误写法：char* get_buf() { char local[4096]; return local; } → setvbuf(fp, get_buf(), ...) 是未定义行为。
为什么不要尝试用 std::ofstream + pubsetbuf 替代 setvbuf
std::filebuf::pubsetbuf 表面类似，但限制更严：
- 必须在
open()之前调用；一旦std::ofstream构造时传了文件名，底层FILE*已打开，pubsetbuf直接返回nullptr - 即使成功，C++ 标准不保证其缓冲行为与
setvbuf完全一致（尤其在行缓冲触发逻辑上） - 跨平台兼容性差：libstdc++ 和 libc++ 对
pubsetbuf的实现细节不同，有些版本忽略_IOLBF
结论：真要控制缓冲，就别绕弯子——用 FILE* + setvbuf，配合 RAII 封装（如 struct File { FILE* fp; ~File() { if (fp) fclose(fp); } };）更可靠。
缓冲区不是越大越好，也不是越小越实时；64–256KB 全缓冲是多数批量写场景的甜点区间。真正难的从来不是调用函数，而是让缓冲区寿命、流生命周期、线程安全这三件事对齐。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
