Golangbufio包输入输出使用教程

本文深入解析了Go语言中使用bufio包进行标准输入输出操作的最佳实践与关键细节，强调其相比fmt和os原生I/O更安全、高效且可控的优势：Scanner专精于健壮的按行读取，Reader提供字节级与Unicode级的精细输入控制，Writer则通过缓冲显著提升批量写入性能；同时重点警示了混用fmt与bufio输入函数所导致的缓冲错位这一高频陷阱，并给出可落地的避坑方案和典型代码示例，帮助开发者写出稳定、可维护的命令行交互程序。

Go 里读写标准输入输出最常用、最稳妥的方式就是用 bufio 包，而不是直接用 fmt.Scan 或 os.Stdin.Read —— 后者在处理换行、缓冲、多字段输入时容易出错或阻塞。

用 bufio.Scanner 安全读取多行输入

bufio.Scanner 是处理行输入的首选，它自动按行切割、处理缓冲，并能规避 bufio.Reader.ReadString('\n') 可能导致的换行符残留问题。

• 默认每行最大 64KB，超长会报 scanner.ErrTooLong；如需读超长行，得提前调 scanner.Buffer 设置缓冲区大小
• 遇到 EOF 或 I/O 错误时，scanner.Scan() 返回 false，错误需用 scanner.Err() 显式检查
• 别用 scanner.Text() 拿空行后的数据——如果上一次 Scan() 失败，Text() 返回的是上次成功的内容，不是当前状态

scanner := bufio.NewScanner(os.Stdin)
for scanner.Scan() {
    line := scanner.Text() // 不含 \n
    fmt.Println("got:", line)
}
if err := scanner.Err(); err != nil {
    log.Fatal(err)
}

用 bufio.Reader 精确控制字节级输入

当需要读单个字符、跳过空白、或混合读取（比如先读 int 再读一行字符串）时，bufio.Reader 更灵活。

• reader.ReadString('\n') 会包含结尾的 \n，记得用 strings.TrimSpace 或切片去掉
• reader.ReadRune() 适合处理 Unicode 字符（如中文），而 ReadByte() 只读 ASCII 字节
• 多次调 ReadString 或 ReadBytes 之间不会丢数据，但 Scanner 和 Reader 不能混用同一个 os.Stdin，否则会相互干扰

reader := bufio.NewReader(os.Stdin)
n, _ := reader.ReadString('\n')
fmt.Printf("raw: %q\n", n) // 比如 "hello\n"

用 bufio.Writer 批量写入提升性能

频繁调 fmt.Print 或 os.Stdout.Write 会产生大量系统调用。bufio.Writer 缓冲后一次性刷出，尤其在循环中写入大量小字符串时效果明显。

• 必须显式调 writer.Flush()，否则程序退出前可能丢失最后几条输出（特别是没换行的）
• 缓冲区大小可自定义：bufio.NewWriterSize(os.Stdout, 4096)，小数据用默认 4KB 就够
• 如果写入内容含大量格式化（如 fmt.Fprintf），优先用 fmt.Fprint(w, ...) 而非先拼接字符串再 w.Write，减少内存分配

w := bufio.NewWriter(os.Stdout)
fmt.Fprintln(w, "hello")
fmt.Fprint(w, "world")
w.Flush() // 必须！

常见陷阱：混用 fmt 和 bufio 导致输入错位

这是新手最容易踩的坑：fmt.Scan、fmt.Scanf 底层直接操作 os.Stdin，和 bufio.Scanner 或 bufio.Reader 共享同一个文件描述符，但缓冲策略不同，会导致“吃掉”本该被 Scanner 读到的输入。

• 例如：先用 fmt.Scan(&n) 读一个整数，再用 scanner.Scan() 读下一行——很可能第二行读到的是空字符串，因为 fmt.Scan 停在换行符前，而 Scanner 从换行符开始读，直接跳到下一行
• 统一使用 bufio.Scanner 或 bufio.Reader，避免和 fmt 输入函数混用
• 如果必须用 fmt.Scanf 解析结构化输入（如 "%d %s"），那就全程用它，别切到 Scanner

缓冲策略不一致这点，往往要 debug 到 stdin 的字节流层面才能看清，别只盯着逻辑。

终于介绍完啦！小伙伴们，这篇关于《Golangbufio包输入输出使用教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！