Go bufio.Reader ReadLine 返回 isPrefix 怎么处理

使用 bufio.Reader.ReadLine 读取长文本时，返回 isPrefix=true 通常不是失败，而是告诉你：本次拿到的 line 只是同一行的前半段，后半段要继续调用 ReadLine。正确做法是循环收集片段，在 isPrefix=false 时才把它们交给上层解析。

官方文档：https://pkg.go.dev/bufio#Reader.ReadLine

先看清 ReadLine 的三个返回值

这次问题的影响面通常出现在日志、配置文件或导入文本中：短行一切正常，遇到一行特别长的内容后，解析器却拿到半截字符串。根因是把 isPrefix 当成“有没有前缀”的业务字段，或者只判断 err 而忽略了它。

ReadLine 返回 (line []byte, isPrefix bool, err error)。当 isPrefix 为 true 时，当前切片是长行片段；当它变成 false 时，当前片段才是这一行的最后一段。读取成功的行不包含行尾的 \n 或 \r\n。

用 isPrefix 拼接一条完整长行

要点是把每次返回的片段追加到调用方拥有的缓冲区，直到 isPrefix=false。示例还把读取错误单独处理：若错误非空，就不能继续把当前内容当成完整业务记录。

package linereader

import (
    "bufio"
    "fmt"
    "io"
)

// readLineParts 把 Reader 返回的多个片段拼成一条不带行尾的文本行。
func readLineParts(r *bufio.Reader) ([]byte, error) {
    var whole []byte

    for {
        part, isPrefix, err := r.ReadLine()
        if err != nil {
            // EOF 只有在没有任何片段时才表示输入已经读完；
            // 如果前面已经收集到内容，则把它作为无换行的最后一行交付。
            if err == io.EOF && len(whole) > 0 {
                return whole, nil
            }
            return nil, fmt.Errorf("read line: %w", err)
        }

        // ReadLine 返回的切片只保证在下一次调用前有效，
        // append 到自有切片后，长行片段才能跨循环安全保存。
        whole = append(whole, part...)
        if !isPrefix {
            return whole, nil
        }
    }
}

这里的 whole 是调用方拥有的切片，下一次读取不会覆盖已经追加的内容。示例把“无终止换行的最后一行”视为正常数据；如果业务要求每行必须以换行结束，可以在接口层额外记录是否看到了终止符，而不能凭 ReadLine 的返回值臆造这个信息。

处理 EOF、空行和 CRLF

ReadLine 的行尾处理很容易造成误判。对于输入 alpha\r\nbeta\n，返回的两行分别是 alpha 和 beta，行尾字节已经被去掉。空行会返回长度为零的 line，但它仍然可能是一个有效记录，不能用“长度为零”判断读取结束。

真正的结束判断来自 err。当输入最后有一行内容但没有换行符时，文档说明不会额外给出“缺少换行”的错误；这与没有任何数据时遇到 io.EOF 不同。调用方要先决定“无换行末行”是否允许，再选择接口语义。

把读取策略封装成可复用接口

直接在业务循环中拼接会让“单行是否允许无限增长”变得不明显。生产代码通常还要设置最大行长：超出上限就返回明确错误，避免恶意或损坏输入持续扩大内存。

package linereader

import (
    "bufio"
    "errors"
    "fmt"
    "io"
)

var ErrLineTooLong = errors.New("line exceeds limit")

// ReadLineLimit 读取一行并限制拼接后的最大字节数。
func ReadLineLimit(r *bufio.Reader, maxBytes int) ([]byte, error) {
    if maxBytes  0 {
                return line, nil
            }
            return nil, fmt.Errorf("read line: %w", err)
        }
        if len(line)+len(part) > maxBytes {
            // 超限后停止读取，调用方可以丢弃或记录当前输入。
            return nil, ErrLineTooLong
        }
        line = append(line, part...)
        if !isPrefix {
            return line, nil
        }
    }
}

如果你不需要低层的片段控制，官方文档也建议优先考虑 ReadBytes('\n')、ReadString('\n') 或 Scanner。但当你需要自定义单行上限、保留错误链或处理超长行时，显式使用 isPrefix 会让边界更清楚。

常见误区与防复发检查

• 不要在 isPrefix=true 时解析 JSON、CSV 或日志字段；此时数据还没有闭合。
• 不要保存下一次调用后仍会使用的原始 line 切片；把它追加到自己的切片或复制出来。
• 不要把空行当作 EOF；空行是内容，EOF 是读取状态。
• 对外部输入设置最大行长，并用 errors.Is 或哨兵错误让上层识别超限原因。

相关问题

isPrefix 为 true 时需要调用多少次 ReadLine？

没有固定次数，取决于行长度和 Reader 缓冲区。持续读取到 isPrefix=false 即可。

ReadLine 会返回换行符吗？

不会，\n 或 \r\n 会被排除。若业务需要保留原始行尾，要换用能返回分隔符的读取方法或自行记录输入格式。

为什么空行不能用 len(line)==0 判断结束？

空行本身是一个有效行，长度为零只说明这一行没有正文；是否结束要看读取返回的错误和行边界。