17370845950

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 行为异常）。

• 读取文本行：直接用 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