当前位置：首页 > 文章列表 > Golang > Go问答 > Go os.File 读写为什么出现 EOF：文件偏移、ReadAt 与游标复位

Go os.File 读写为什么出现 EOF：文件偏移、ReadAt 与游标复位

来源：17golang原创 2026-08-27 10:48:08 0浏览收藏

排查文件导入时，最容易让人误判的一行日志是 read config: EOF。文件明明刚写入了内容，紧接着用同一个 *os.File 读取却像空文件一样。多数情况下，磁盘上的字节并没有消失，只是文件偏移已经停在写入末尾，下一次顺序读取自然得到 io.EOF。

要点速览

os.File.Read 使用并推进共享文件偏移，写完再读前要先确认偏移位置。
ReadAt 从指定字节位置读取，不改变共享偏移，适合并发或固定区段读取。
Seek(0, io.SeekStart) 可把顺序读取游标复位到文件开头，但不能替代错误检查。
读到 EOF 只说明当前读取位置没有更多字节，不等于文件长度为零。

先看清楚：EOF 反映的是当前位置

os.File 同时实现了 io.Reader、io.Writer 和 io.Seeker。其中 Read 与 Write 共用一个文件偏移。下面这段代码先写入 11 个字节，再从同一个句柄顺序读取：

package main

import (
    "fmt"
    "io"
    "os"
)

func main() {
    f, err := os.CreateTemp("", "offset-demo-*.txt")
    if err != nil { panic(err) }
    defer os.Remove(f.Name())
    defer f.Close()

    if _, err = f.WriteString("hello world"); err != nil {
        panic(err)
    }

    buf := make([]byte, 32)
    n, err := f.Read(buf)
    fmt.Printf("n=%d err=%v\n", n, err)
    _ = io.EOF
}

输出通常是 n=0 err=EOF。写入成功后偏移在 11，读取从 11 开始，文件尾部没有可读字节。先别急着怀疑 WriteString 没落盘，查看当前位置就能验证判断：

pos, err := f.Seek(0, io.SeekCurrent)
fmt.Printf("offset=%d err=%v\n", pos, err)

Go os.File 写入后共享偏移停在文件末尾，顺序 Read 直接得到 EOF 的工程证据场景

三种读取方式，差别在于谁负责移动游标

同一个文件可以用顺序读取，也可以用定位读取。选择时只要盯住“是否改变共享偏移”这一点：

方式	起始位置	是否改变共享偏移	适合场景
`Read`	当前偏移	会推进	单线程顺序扫描
`Seek` + `Read`	手动定位	会推进	复位后重新顺序读
`ReadAt`	指定 offset	不改变	固定区段或并发读取

需要连续读，就显式复位

写入完成后把偏移移回起点，再使用普通 Read：

if _, err := f.Seek(0, io.SeekStart); err != nil {
    panic(err)
}

n, err := f.Read(buf)
if err != nil && err != io.EOF {
    panic(err)
}
fmt.Printf("content=%q bytes=%d\n", buf[:n], n)

这里的检查顺序很重要：Read 可能同时返回有效字节和 io.EOF，不要因为看到 EOF 就丢掉 n 个字节。更稳妥的循环应先处理 n>0，再判断错误。

只读固定区段，就用 ReadAt

ReadAt 把起点作为参数传入，不依赖当前游标。例如读取文件开头 5 个字节：

header := make([]byte, 5)
n, err := f.ReadAt(header, 0)
if err != nil && err != io.EOF {
    panic(err)
}
fmt.Printf("header=%q bytes=%d\n", header[:n], n)

当目标区段不足缓冲区长度时，ReadAt 可能返回 n>0 和 io.EOF。这代表“读到文件尾”，不是“一个字节都没读到”。

Go ReadAt 从指定字节下标读取固定区段，短读与 EOF 在文件边界处同时出现的对照图

文件偏移相关的三个常见误区

把 EOF 当成文件为空

先用 Stat 查看文件大小，再结合当前偏移判断：

info, err := f.Stat()
if err != nil { panic(err) }
pos, err := f.Seek(0, io.SeekCurrent)
if err != nil { panic(err) }
fmt.Printf("size=%d offset=%d\n", info.Size(), pos)

如果 size>0 且 offset==size，读到 EOF 就是正常的游标结果。