Go os.File.ReadFrom 在 Seek 后怎样从指定偏移写入

我在处理文件续写时最容易先问错一个问题：os.File.ReadFrom 有没有类似 WriteAt 的偏移参数？答案是没有。它从目标文件当前的 I/O 偏移开始写；如果想从指定位置写入，先对同一个文件句柄调用 Seek，再调用 ReadFrom。

这意味着“写到哪里”和“从哪里读”是两件事：Seek 决定目标文件的下一次读写位置，ReadFrom 负责从 io.Reader 持续取数据。下面把偏移、返回值和文件尾部三个容易混淆的点拆开。

ReadFrom 的写入起点由谁决定

File.ReadFrom 实现了 io.ReaderFrom 接口，读取会持续到源 reader 返回 EOF 或其他错误。它本身不接收 offset，所以目标文件的写入起点只能来自文件句柄当前偏移。

因此基本组合始终是“定位，再流式写入”。例如目标文件原本是 0123456789，定位到偏移 4 后写入 ABC，写入区间就是原来的第 4、5、6 个字节，结果会变成 0123ABC789。这属于覆盖，不会自动把后面的内容整体右移。

Seek 后怎样把数据写到指定偏移

示例把目标文件打开为可读写、创建并截断，然后先写入一段初始内容。真正需要关注的是 Seek 的返回值：返回的新偏移应该等于目标位置，错误则必须在调用 ReadFrom 前结束当前操作。

package main

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

func main() {
    // 示例使用临时文件，避免覆盖已有业务文件。
    f, err := os.OpenFile("offset-demo.txt", os.O_RDWR|os.O_CREATE|os.O_TRUNC, 0o644)
    if err != nil {
        panic(err)
    }
    defer f.Close() // 函数结束时释放文件描述符。

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

    // Seek 设置下一次 Read 或 Write 的起点；io.SeekStart 表示从文件开头计算。
    position, err := f.Seek(4, io.SeekStart)
    if err != nil {
        panic(err)
    }
    if position != 4 {
        panic(fmt.Sprintf("unexpected offset: %d", position))
    }

    // ReadFrom 从当前偏移开始读取源数据并写入目标文件。
    n, err := f.ReadFrom(strings.NewReader("ABC"))
    if err != nil {
        panic(err)
    }
    fmt.Printf("offset=%d bytes=%d\\n", position, n)
}

这个例子中 n 应表示从 reader 读到并写入的字节数。ReadFrom 成功读到 EOF 时，EOF 不是需要单独报错的失败；真正需要处理的是除 EOF 之外返回的错误。

n 和 err 怎样一起判断

只看 err == nil 不够稳妥，流式写入应该同时保留 n。如果源 reader 在中途返回错误，n 仍然可能大于零，表示前面已经有一部分数据写入；这时不能把目标文件当成完整更新。

在可恢复的业务代码中，可以把“写入了多少”和“是否完整结束”一起返回给上层。下面这个小函数只负责定位和写入，不把局部成功伪装成完整成功：

func writeFromOffset(dst *os.File, offset int64, src io.Reader) (int64, error) {
    // 先定位目标文件，避免把 offset 误当成 ReadFrom 的参数。
    actual, err := dst.Seek(offset, io.SeekStart)
    if err != nil {
        return 0, fmt.Errorf("seek to %d: %w", offset, err)
    }
    if actual != offset {
        return 0, fmt.Errorf("seek returned %d, want %d", actual, offset)
    }

    // n 记录已经从 src 读取并写入的字节数；非 nil 错误不能被吞掉。
    n, err := dst.ReadFrom(src)
    if err != nil {
        return n, fmt.Errorf("read from source after %d bytes: %w", n, err)
    }
    return n, nil
}

如果业务要求失败后重试，重试策略应该由上层决定，例如重新准备目标文件或确认已写入区间，而不是无条件再次从同一个不明状态继续写。

覆盖、文件尾部和追加模式不要混为一谈

把偏移理解清楚后，下面几个结果就比较直观：

另外，不要用 O_APPEND 来表达“先 Seek 再精确覆盖”。官方文档明确指出，文件以 O_APPEND 打开时，Seek 的行为未指定；如果目标是可预测的指定偏移写入，就不要把追加语义和定位语义叠在一起。

常见问题

ReadFrom 能不能直接传入 offset？

不能。先对目标文件调用 Seek(offset, io.SeekStart)，检查返回值和错误，再调用 ReadFrom。

ReadFrom 返回 EOF 要当成失败吗？

读到源数据末尾属于正常结束。重点是保留返回的 n，并处理除 EOF 之外的错误；中途错误时，n 可能已经大于零。

记住一句话即可：Seek 管目标文件的当前位置，ReadFrom 管从 reader 搬多少数据；两者组合后，写入起点就是调用时的当前偏移。