Go Reader 为什么最后一行没有换行

我第一次遇到“Go Reader 最后一行没有换行”时，问题并不在 Reader 把字符吃掉了，而在我把“文件结束”和“换行符”当成了同一件事。一个输入可以完整地包含 hello，却没有最后的 \n；io.EOF 只表示后面没有更多字节，并不会自动补一个换行。

判断这类问题，先看原始输入是否真的带行尾，再看读取 API 是否主动去掉行尾，最后才决定展示时要不要补换行。这个顺序能同时解释 io.Reader、bufio.Scanner 和 bufio.Reader.ReadString 的不同表现。

先把 EOF 和换行符分开

文本行通常由“内容 + 行结束符”组成，但最后一行可以只有内容。比如输入 alpha\nbeta 有两段文本，第一段后面有换行，第二段到输入结束就停止；输入并没有承诺在 beta 后再放一个 \n。

io.Reader.Read 返回的是字节数和错误。官方约定允许一次读取既拿到最后一段数据，又得到 io.EOF；也允许先返回数据，下一次再返回 0, io.EOF。所以调用方永远应该先处理 n > 0，再判断 err：

func consume(r io.Reader, dst io.Writer) error {
    buf := make([]byte, 32*1024)
    for {
        n, err := r.Read(buf)
        if n > 0 {
            // 先写出已经读到的字节，最后一段可能和 EOF 同次返回。
            if _, writeErr := dst.Write(buf[:n]); writeErr != nil {
                return fmt.Errorf("写出数据失败: %w", writeErr)
            }
        }
        if err == io.EOF {
            // EOF 是输入边界，不是需要写入的换行字符。
            return nil
        }
        if err != nil {
            return fmt.Errorf("读取数据失败: %w", err)
        }
    }
}

这里如果把判断写成“先遇到错误就返回”，就可能丢掉 n > 0 的尾部内容；如果把 EOF 当成 \n 写入，又会改变原始文件。对我来说，最重要的边界是：是否补换行属于输出策略，不属于 Reader 的职责。

Scanner 为什么看不到行尾

bufio.NewScanner 默认使用 bufio.ScanLines。这个分割函数会去掉末尾的 \n，也会处理可选的 \r；当最后一段非空内容没有换行时，它仍然会把这段内容返回。所以 scanner.Text() 没有换行，并不能证明输入丢了换行。

func printLines(r io.Reader, w io.Writer) error {
    scanner := bufio.NewScanner(r)
    for scanner.Scan() {
        // Text 返回的是去掉行尾标记后的 token；展示层决定是否补换行。
        if _, err := fmt.Fprintln(w, scanner.Text()); err != nil {
            return fmt.Errorf("输出文本失败: %w", err)
        }
    }
    if err := scanner.Err(); err != nil {
        // Scanner 会把正常 EOF 视为结束，Err 只报告其他读取错误。
        return fmt.Errorf("扫描文本失败: %w", err)
    }
    return nil
}

如果把 fmt.Fprintln 换成 fmt.Fprint，终端上就会看到行与行粘在一起，这是输出函数没有补换行，而不是 Scanner 少读了一个字节。需要保留原始换行时，不要用默认的 ScanLines 作为字节复制器。

需要保留分隔符时，用 ReadString 看清 EOF

bufio.Reader.ReadString('\n') 找到分隔符时会把分隔符一起放进返回字符串；如果输入末尾没有分隔符，它会返回已经读到的内容和 io.EOF。因此循环不能只在 err == nil 时处理字符串：

func readRecords(r io.Reader, w io.Writer) error {
    br := bufio.NewReader(r)
    for {
        line, err := br.ReadString('\n')
        if len(line) > 0 {
            // 有内容就先处理；最后残行可能没有 '\n' 且同时带 EOF。
            if _, writeErr := io.WriteString(w, line); writeErr != nil {
                return fmt.Errorf("写出记录失败: %w", writeErr)
            }
        }
        if err == io.EOF {
            // 这里不额外补字节，是否展示换行交给调用方决定。
            return nil
        }
        if err != nil {
            return fmt.Errorf("读取记录失败: %w", err)
        }
    }
}

这个版本适合需要保留输入行尾的场景，例如文本转存或协议内容处理。若业务要求每条记录最终都以换行结束，可以在写出层显式规范化，但应先说明这是格式化规则，而不是声称原文件本来就有换行。

最后一行的处理选择

我的选择通常很简单：只做“按行读取和业务解析”时用 Scanner，接受它返回不带行尾的 token；要区分分隔符是否存在时用 ReadString；要原样复制字节时直接遵守 Reader 的 n 与 err 约定。不要为了让日志看起来整齐，就把 Insecure 式的忽略思路套到文本边界上，直接吞掉错误。

如果产品格式明确要求末尾换行，可以把规则集中在一个小函数里，避免每个调用点各自猜测：

func ensureTrailingNewline(s string) string {
    // 只在展示或导出格式明确要求时补换行，不修改解析得到的原始文本。
    if strings.HasSuffix(s, "\n") {
        return s
    }
    return s + "\n"
}

这样既能保留读取层的事实，也能让导出层拥有一致格式。排查时可以按三问收尾：输入最后一个字节是什么？使用的 API 是否去掉了行尾？当前代码是在解析原文，还是在生成展示文本？

相关问题

• Scanner 会不会漏掉没有换行的最后一行？ 不会。默认的 ScanLines 会返回最后一段非空内容，即使它没有最终换行。
• ReadString 返回内容和 io.EOF 时要不要丢弃内容？ 不要。先处理非空内容，再把 EOF 当作输入结束。
• 为什么 fmt.Print 输出看起来少了换行？ 因为 Print 不会自动补换行；可以改用 Fprintln，或在明确的展示层显式补一个。