Go bufio.Reader 读取一行时 ReadString 和 ReadBytes 怎么选
来源:17golang原创
时间:2026-09-10 15:23:30 258浏览 收藏
用 bufio.Reader 读取文本记录时,ReadString 和 ReadBytes 的读取边界几乎相同:都读到第一个分隔符,并把分隔符一起放进结果。真正决定怎么选的是返回类型。后续逻辑需要 string,例如按字符串解析字段,就用 ReadString;需要保留原始字节、交给二进制协议解析或避免立刻做字符串转换,就用 ReadBytes。
ReadString(delim)返回string,ReadBytes(delim)返回新分配的[]byte。- 两者都保留
delim,不会自动删除\n或\r\n。 - 末行没有分隔符时,非空数据和
io.EOF可能同时出现,必须先处理数据。
先看返回类型:字符串处理还是字节处理
这两个方法的参数都是一个 byte,常见写法是传入 '\n'。假设输入是 name=go\nname=rust\n,第一次调用会得到包含换行的第一条记录。区别只在结果容器:ReadString 适合马上调用 strings.TrimSuffix、strings.Split 等字符串 API;ReadBytes 适合先检查原始字节、按协议字段切分,或把数据写入另一个 io.Writer。
![Go bufio.Reader ReadString 与 ReadBytes 按分隔符读取时的 string 和 []byte 数据边界关系图](/uploads/20260910/1789025009-d2653e7a11-d8f8e6ceab-readstring-readbytes-type-boundary.webp)
示例中不要把两个函数当成“一个快、一个慢”的开关。当前 Go 源码里,它们共享按分隔符收集片段的读取路径,之后分别组装成字符串或字节切片。选型应由调用方的数据类型决定:
| 需求 | 建议 | 原因 |
|---|---|---|
| 文本清洗、字段拆分 | ReadString | 直接进入字符串 API |
| 二进制协议或原样转发 | ReadBytes | 保留字节表达,少一次显式转换 |
| 需要借用内部缓冲区 | 另看 ReadSlice | 但下一次读取会覆盖返回内容 |
分隔符会保留,换行清理要由业务决定
ReadString('\n') 返回的字符串可能以 \n 结尾,Windows 风格输入还可能是 \r\n。如果业务只要正文,可以显式去掉行尾;如果协议把换行当作记录的一部分,就应该保留它。分隔符参数是单字节,不适合直接表达多字节字符串。
package main
import (
"bufio"
"fmt"
"io"
"strings"
)
func readText(r io.Reader) error {
reader := bufio.NewReader(r)
for {
line, err := reader.ReadString('\n')
// 先处理已经读到的内容,最后一行可能没有换行符。
if line != "" {
line = strings.TrimSuffix(line, "\n")
line = strings.TrimSuffix(line, "\r")
fmt.Printf("record=%q\n", line)
}
if err != nil {
// EOF 表示输入结束;其他错误需要交给调用方。
if err == io.EOF {
return nil
}
return err
}
}
}
这里连续两次 TrimSuffix 是为了同时覆盖 \r\n 和单独的 \n,并没有改变正文中其他位置的字符。若输入字段本身允许行尾空格,不要用无条件的 strings.TrimSpace,否则会扩大清理范围。
没有换行符时,数据和 io.EOF 要一起判断
最容易漏数据的写法是“只有 err == nil 才处理结果”。当输入最后一条记录没有 \n 时,ReadString 或 ReadBytes 会把已读到的内容返回出来,同时报告常见的 io.EOF。文档还规定:如果返回数据没有以分隔符结束,错误值就不会是 nil。因此循环要先判断结果是否非空,再判断错误。

字节版本的核心判断完全相同,只是把空字符串换成 len(data) > 0:
func readBytes(r io.Reader) error {
reader := bufio.NewReader(r)
for {
data, err := reader.ReadBytes('\n')
// []byte 适合在转换成 string 前先做协议级判断。
if len(data) > 0 {
fmt.Printf("bytes=%q\n", data)
}
if err != nil {
// 没有最终换行的尾部数据已经处理,EOF 可作为正常结束。
if err == io.EOF {
return nil
}
return err
}
}
}
若某次返回了非空数据和非 EOF 错误,也不要静默丢弃数据后直接重试;是否提交这条残片取决于协议,但错误本身必须被记录或返回。
长行和缓冲区边界:不要把三个 API 混为一谈
ReadString 和 ReadBytes 会收集跨越内部缓冲区的片段,适合不确定长度但仍要得到完整记录的场景;代价是长行会占用与结果相关的内存。ReadSlice 返回的是指向缓冲区的切片,下一次读操作后就可能失效,缓冲区装不下且还没遇到分隔符时还会返回 bufio.ErrBufferFull。只有在能及时消费或复制切片时才考虑它。
如果业务只需要按行扫描、没有自定义分隔符和超长行要求,bufio.Scanner 往往更简洁;但 Scanner 有自己的 token 大小上限,需要通过 Buffer 调整。这个判断和 ReadString、ReadBytes 的返回类型选择是两件事。
常见问题
ReadString 会自动去掉换行吗?
不会。它把分隔符包含在返回字符串中,是否删除 \n 或 \r\n 由业务代码决定。
ReadBytes 比 ReadString 更适合大文件吗?
不能只这样判断。两者都会为完整结果收集数据;应按后续是字符串处理还是字节处理选择,超长记录则要单独评估内存。
最后一行没有换行时应该忽略吗?
通常不应忽略。只要返回数据非空,就先把它作为一条记录处理,再把 io.EOF 视为输入结束。
-
459 收藏
-
215 收藏
-
Golang · Go教程 | 51分钟前 | bufio · EOF · scanner · Go教程 · SplitFunc · 文本分词 · Go token bufio.Scanner SplitFunc atEOF ErrFinalToken243 收藏
-
Golang · Go教程 | 1小时前 | 错误处理 · bufio · Go教程 · 文本读取 · 内存边界 · Go bufio.Scanner Scanner.Buffer 超长行 MaxScanTokenSize ScanLines414 收藏
-
Golang · Go教程 | 1小时前 | 网络编程 · 错误处理 · Go教程 · 超时处理 · io包 · Go 网络超时 net.Conn io.CopyN SetReadDeadline 固定长度复制447 收藏
-
470 收藏
-
Golang · Go教程 | 1小时前 | 错误处理 · Go教程 · 流式读取 · io包 · 短读 · Go io.Reader io.EOF io.CopyN ErrUnexpectedEOF ReadFull199 收藏
-
281 收藏
-
180 收藏
-
333 收藏
-
427 收藏
-
115 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习