Go 的 bufio 包通过缓冲 io.Reader 和 io.Writer 减少系统调用,提升 I/O 性能;bufio.Reader 批量读取并缓存数据,推荐用 ReadString('\n') 或 Scanner 逐行读取;bufio.Writer 缓存写入,需显式 Flush();避免嵌套使用 Scanner 和 bufio.Reader。

在 Go 中,bufio 包通过为 io.Reader 和 io.Writer 添加缓冲层,显著减少系统调用次数,从而提升 I/O 性能。它不改变底层行为,只优化读写频率和粒度,特别适合处理大量小数据块(如逐行读取日志、分块写入文件)的场景。
使用 bufio.Reader 高效缓冲读取
bufio.Reader 在内部维护一个字节切片缓冲区,每次从底层 Reader(如 *os.File 或 net.Conn)批量读取数据,后续的 Read、ReadString、ReadBytes、Scan 等操作优先从缓冲区获取,避免频繁系统调用。
- 创建时可指定缓冲区大小(默认 4096 字节),对大文件或高吞吐场景建议适当调大(如 64KB),但不宜过大以免浪费内存
- 推荐用
ReadString('\n')或结合Scanner逐行读取——Scanner底层就封装了bufio.Reader,且自动处理行末截断和 UTF-8 边界 - 注意:
ReadString会包含换行符,Scanner.Text()默认不包含;若需保留原始换行,可用Scanner.Bytes()
使用 bufio.Writer 高效缓冲写入
bufio.Writer 将写入操作暂存到内存缓冲区,仅当缓冲区满、显式调用 Flush() 或关闭时才真正写入底层 Writer。这大幅降低 write() 系统调用频次,尤其对高频小写入(如日志逐条输出)效果明显。
- 务必在写入完成后调用
Flush(),否则缓冲区中剩余数据可能丢失;常见做法是用defer w.Flush()或配合defer关闭资源 - 写入过程中若发生错误(如磁盘满),
Flush()才会返回该错误;因此不能仅靠单次Write()返回值判断成败 - 缓冲区大小影响吞吐:太小导致频繁 flush,太大增加延迟;一般 4KB–64KB 是较稳妥的选择
组合使用 Reader/Writer 与 Scanner / Writer 接口
不要手动混合 bufio.Reader 和 Scanner——Scanner 已内置缓冲,再套一层 bufio.Reader 不仅冗余,还可能导致状态错乱(如 Peek 或 UnreadRune 行为异常)。
立即学习“go语言免费学习笔记(深入)”;
- 读取文本行:直接用
scanner := bufio.NewScanner(file),必要时设置scanner.Buffer(nil, 1 提升大行支持能力 - 写入结构化数据:用
fmt.Fprintln(w, data)或w.WriteString(s),它们都走缓冲;避免用fmt.Println直接输出到文件(无缓冲) - 需要精确控制二进制读写?优先用原生
io.ReadFull/binary.Read,仅在确认存在性能瓶颈时再考虑加bufio层
注意事项与常见陷阱
bufio 是工具,不是银弹。不当使用反而引入 bug 或掩盖问题。
- 缓冲区是独占的:同一个
bufio.Reader不能被多个 goroutine 并发调用,需加锁或为每个 goroutine 创建独立实例 - 底层 reader/writer 被包装后,原始接口方法(如
file.Seek)不可再直接调用;如有随机访问需求,应绕过bufio或先Flush()+ 重置 - 网络连接中使用
bufio.Reader时,注意超时控制——缓冲区可能阻塞在等待更多数据,需合理设置conn.SetReadDeadline










