buffering参数控制文件i/o缓冲策略：默认-1启用系统默认缓冲（通常8192字节）及文本模式行缓冲；设0禁用缓冲（仅二进制模式），设1启用行缓冲（仅文本模式），设大于1的整数指定缓冲区字节大小。
buffering 参数控制什么，不设会怎样
open() 的 buffering 参数决定 Python 是否启用缓冲、用多大内存做缓冲，以及是否强制行缓冲。不传这个参数时，默认值是 -1，表示“使用系统默认缓冲大小”，通常是 8192 字节（8KB），且对文本模式自动启用行缓冲（遇到换行才刷出）。
但要注意：这个“默认”不是固定值，它依赖 io.DEFAULT_BUFFER_SIZE，而该值在不同平台或 Python 版本下可能变化；更重要的是，它不等于“最合理”——比如你频繁写入小字符串，用 8KB 缓冲反而拖慢响应；又或者你在日志场景需要逐行实时落盘，却因缓冲卡住几秒才写入。
什么时候该显式设 buffering，设多少合适
-
buffering=0：仅适用于二进制模式（mode='rb' 或 'wb'），禁用所有缓冲，每次 write() 都直通系统调用。适合对延迟敏感的设备通信（如串口模拟文件），但性能极差，普通磁盘 I/O 别用。
-
buffering=1：仅对文本模式有效，启用行缓冲——每次写入含 \n 就立即刷出。适合日志、交互式输出等需“所见即所得”的场景。
-
buffering=N（N > 1）：指定字节级缓冲区大小，比如 buffering=4096。适合已知单次读写量较稳定的情况（如批量处理固定大小的数据块），能减少系统调用次数。
-
buffering=-1（默认）：让 Python 自行决定缓冲策略和大小，多数情况够用，但不可控。
buffering=0：仅适用于二进制模式（mode='rb' 或 'wb'），禁用所有缓冲，每次 write() 都直通系统调用。适合对延迟敏感的设备通信（如串口模拟文件），但性能极差，普通磁盘 I/O 别用。buffering=1：仅对文本模式有效，启用行缓冲——每次写入含 \n 就立即刷出。适合日志、交互式输出等需“所见即所得”的场景。buffering=N（N > 1）：指定字节级缓冲区大小，比如 buffering=4096。适合已知单次读写量较稳定的情况（如批量处理固定大小的数据块），能减少系统调用次数。buffering=-1（默认）：让 Python 自行决定缓冲策略和大小，多数情况够用，但不可控。常见误用：在文本模式下设 buffering=0 会直接报错 ValueError: can't have unbuffered text I/O。
如何验证缓冲行为是否生效
最直接的方式是观察写入后文件内容是否立刻可见：
import time
with open('test.log', 'w', buffering=1) as f:
f.write('start\n')
print('文件大小（写入后）:', len(open('test.log', 'rb').read()))
time.sleep(2)
f.write('done\n')
对比 buffering=8192 的情况，你会发现前者第一次 write 后文件立刻有 6 字节（'start\n'），后者要等第二次写入填满缓冲或显式 f.flush() 才写入磁盘。
也可以用 f.buffer 查看底层缓冲对象（文本文件的 f 是封装层，真正缓冲在 f.buffer）：
print(f.buffer.write_through) # False 表示有缓冲
print(f.buffer.raw.fileno()) # 底层文件描述符
和 flush()、close() 的关系容易被忽略
buffering 只影响“何时自动刷出”，不影响“是否必须刷出”。即使设了 buffering=1，如果最后一行没换行符，close() 前内容仍可能滞留在缓冲里；同理，flush() 总是强制刷出当前缓冲内容，与 buffering 值无关。
所以关键点是：
- 不依赖
close()来保证数据落地，尤其在异常退出风险高的场景，应主动flush() -
buffering=1不代表“每字符都刷”，只代表“每行结束刷”，没有\n就不算一行 - 多进程/多线程共写一个文件时，缓冲行为叠加可能导致乱序，此时更推荐用
buffering=0（二进制）+ 显式锁，或改用日志库
缓冲策略不是越小越好，也不是越大越好，得看你的数据节奏和可靠性要求。很多问题其实不出在缓冲本身，而出在假设“写了就等于落盘”这个误解上。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
