复用同一Reader创建新bufio.Scanner为何直接返回EOF（源数据未读完）

我有一个内容如下的文件：

3
09:00 19:00
10
someText1
someText2
... 

首先我读取文件的前3行作为配置：

sourceFile, err := os.OpenFile(fileName, os.O_RDONLY, 0644)
cfg := ReadConfig(sourceFile)

func ReadConfig(r io.Reader) Config {
    scanner := bufio.NewScanner(r)
    var cfg Config
    for i := 0; i < 3 && scanner.Scan(); i++ {
        switch i {
        case 0:
            cfg.Parts, _ = strconv.Atoi(scanner.Text())
        case 1:
            timeParts := strings.Split(scanner.Text(), " ")
            cfg.Start, _ = time.Parse("15:04", timeParts[0])
            cfg.End, _ = time.Parse("15:04", timeParts[1])
        case 2:
            cfg.Val, _ = strconv.Atoi(scanner.Text())
        }
    }
    return cfg
}

配置读取正常，之后我在另一个函数中读取剩余内容：

Read(ctx, sourceFile)

func Read(ctx context.Context, r io.Reader) error {
    scanner := bufio.NewScanner(r)
    for scanner.Scan() {
            event := parseEvent(scanner.Text())
    }
    return nil
}

但读取操作未执行，直接返回了EOF。明明只读取了3行，为何会出现这种情况？

问题出在bufio.Scanner的缓冲机制上：

• 当你在ReadConfig里使用bufio.Scanner读取文件时，Scanner会从文件句柄中预读取一大块数据到内部缓冲区，而不是只读取你需要的3行。
• 这会导致文件的读写指针（offset）直接被移动到缓冲区覆盖的位置，甚至可能直接跳到文件末尾。
• 后续用新的bufio.Scanner读取同一个文件句柄时，剩下的可读数据已经被之前的Scanner缓冲走了，自然直接返回EOF。

有几种实用的解决办法：

1. 复用同一个Scanner #

在ReadConfig中保留Scanner实例并传递给后续读取函数，这样可以继续读取剩余内容：

func ReadConfig(r io.Reader) (Config, *bufio.Scanner) {
    scanner := bufio.NewScanner(r)
    var cfg Config
    for i := 0; i < 3 && scanner.Scan(); i++ {
        // 原有的配置解析逻辑
        switch i {
        case 0:
            cfg.Parts, _ = strconv.Atoi(scanner.Text())
        case 1:
            timeParts := strings.Split(scanner.Text(), " ")
            cfg.Start, _ = time.Parse("15:04", timeParts[0])
            cfg.End, _ = time.Parse("15:04", timeParts[1])
        case 2:
            cfg.Val, _ = strconv.Atoi(scanner.Text())
        }
    }
    return cfg, scanner
}

// 调用时
cfg, scanner := ReadConfig(sourceFile)
Read(ctx, scanner)

// 修改Read函数接收Scanner
func Read(ctx context.Context, scanner *bufio.Scanner) error {
    for scanner.Scan() {
        event := parseEvent(scanner.Text())
    }
    return scanner.Err()
}

2. 手动重置文件指针 #

如果必须分开使用不同读取器，可以在读取配置后重置文件指针到开头，再跳过前3行读取剩余内容：

cfg := ReadConfig(sourceFile)
// 重置文件指针到文件开头
_, err := sourceFile.Seek(0, io.SeekStart)
if err != nil {
    // 处理错误
}
// 重新跳过前3行
scanner := bufio.NewScanner(sourceFile)
for i := 0; i < 3 && scanner.Scan(); i++ {}
// 读取剩余内容
for scanner.Scan() {
    event := parseEvent(scanner.Text())
}

3. 精确跟踪读取字节数 #

使用bufio.Reader手动读取每一行并记录读取的字节数，之后通过Seek精确回到配置读取结束的位置：

func ReadConfig(r *os.File) (Config, int64, error) {
    br := bufio.NewReader(r)
    var cfg Config
    var totalBytes int64

    // 读取第一行
    line, err := br.ReadString('\n')
    if err != nil {
        return cfg, 0, err
    }
    totalBytes += int64(len(line))
    cfg.Parts, _ = strconv.Atoi(strings.TrimSpace(line))

    // 读取第二行
    line, err = br.ReadString('\n')
    if err != nil {
        return cfg, 0, err
    }
    totalBytes += int64(len(line))
    timeParts := strings.Split(strings.TrimSpace(line), " ")
    cfg.Start, _ = time.Parse("15:04", timeParts[0])
    cfg.End, _ = time.Parse("15:04", timeParts[1])

    // 读取第三行
    line, err = br.ReadString('\n')
    if err != nil && err != io.EOF {
        return cfg, 0, err
    }
    totalBytes += int64(len(line))
    cfg.Val, _ = strconv.Atoi(strings.TrimSpace(line))

    return cfg, totalBytes, nil
}

// 调用时
cfg, bytesRead, err := ReadConfig(sourceFile)
if err != nil {
    // 处理错误
}
// 移动指针到配置结束的位置
_, err = sourceFile.Seek(bytesRead, io.SeekStart)
if err != nil {
    // 处理错误
}
// 读取剩余内容
Read(ctx, sourceFile)

内容的提问来源于stack exchange，提问作者Alpharius