登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go bufio.Reader 读取一行时 ReadString 和 ReadBytes 怎么选

来源:17golang原创

时间:2026-09-10 15:23:30 258浏览 收藏

bufio.Reader 读取文本记录时,ReadStringReadBytes 的读取边界几乎相同:都读到第一个分隔符,并把分隔符一起放进结果。真正决定怎么选的是返回类型。后续逻辑需要 string,例如按字符串解析字段,就用 ReadString;需要保留原始字节、交给二进制协议解析或避免立刻做字符串转换,就用 ReadBytes

要点速览
  • ReadString(delim) 返回 stringReadBytes(delim) 返回新分配的 []byte
  • 两者都保留 delim,不会自动删除 \n\r\n
  • 末行没有分隔符时,非空数据和 io.EOF 可能同时出现,必须先处理数据。

先看返回类型:字符串处理还是字节处理

这两个方法的参数都是一个 byte,常见写法是传入 '\n'。假设输入是 name=go\nname=rust\n,第一次调用会得到包含换行的第一条记录。区别只在结果容器:ReadString 适合马上调用 strings.TrimSuffixstrings.Split 等字符串 API;ReadBytes 适合先检查原始字节、按协议字段切分,或把数据写入另一个 io.Writer

Go bufio.Reader ReadString 与 ReadBytes 按分隔符读取时的 string 和 []byte 数据边界关系图
图1:ReadString 与 ReadBytes 的主要差别是结果类型和后续数据边界,不是读取到哪个分隔符。

示例中不要把两个函数当成“一个快、一个慢”的开关。当前 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 时,ReadStringReadBytes 会把已读到的内容返回出来,同时报告常见的 io.EOF。文档还规定:如果返回数据没有以分隔符结束,错误值就不会是 nil。因此循环要先判断结果是否非空,再判断错误。

Go bufio.Reader ReadString 和 ReadBytes 处理末尾无换行数据与 io.EOF 的边界关系图
图2:最后一行没有换行时,ReadString 或 ReadBytes 仍会返回残留数据,循环不能只按 err == 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 混为一谈

ReadStringReadBytes 会收集跨越内部缓冲区的片段,适合不确定长度但仍要得到完整记录的场景;代价是长行会占用与结果相关的内存。ReadSlice 返回的是指向缓冲区的切片,下一次读操作后就可能失效,缓冲区装不下且还没遇到分隔符时还会返回 bufio.ErrBufferFull。只有在能及时消费或复制切片时才考虑它。

如果业务只需要按行扫描、没有自定义分隔符和超长行要求,bufio.Scanner 往往更简洁;但 Scanner 有自己的 token 大小上限,需要通过 Buffer 调整。这个判断和 ReadString、ReadBytes 的返回类型选择是两件事。

常见问题

ReadString 会自动去掉换行吗?

不会。它把分隔符包含在返回字符串中,是否删除 \n\r\n 由业务代码决定。

ReadBytes 比 ReadString 更适合大文件吗?

不能只这样判断。两者都会为完整结果收集数据;应按后续是字符串处理还是字节处理选择,超长记录则要单独评估内存。

最后一行没有换行时应该忽略吗?

通常不应忽略。只要返回数据非空,就先把它作为一条记录处理,再把 io.EOF 视为输入结束。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>