Go 问答：os.File.ReadFrom 何时走快速路径：偏移变化与短写错误

把上传内容落到临时文件时，很多人会直接写成 io.Copy(dst, src)，随后发现同样的输入在普通文件、管道和自定义 Reader 上表现不一样。答案是：os.File.ReadFrom 会参与这条调用链，但是否进入平台专用的快速路径，要看文件和输入是否满足当前平台的条件；即使没有快速路径，通用读取也仍然是正确结果，不能把“慢”误判成“少写了数据”。

os.File.ReadFrom 先校验文件可写状态，再尝试内部 readFrom；专用路径没有接管时才回退到 genericReadFrom。判断成功要同时看返回字节数、错误值和最终文件偏移。

先看清 io.Copy 到 os.File 的调用链

这段代码的重点不是把文件 API 背下来，而是知道优化入口在哪里。io.Copy 会检查目标是否实现 io.ReaderFrom；*os.File 提供了 ReadFrom，所以复制目标是文件时，调用会落到这个方法。

src, err := os.Open("payload.bin")
if err != nil {
    return err
}
defer src.Close()

dst, err := os.OpenFile("payload.copy", os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0o600)
if err != nil {
    return err
}
defer dst.Close()

n, err := io.Copy(dst, src)
fmt.Println(n, err)

这里的第一条可核对证据是 Go 标准库的接口关系：ReadFrom 实现的是 io.ReaderFrom，而 os.File.ReadFrom 的公开职责是把 Reader 的内容写入文件。图片把这条调用链压缩成几个节点，避免把平台细节画成一张泛化的“高速通道”海报。

readFrom 为什么有时会交给专用路径

ReadFrom 的实现先调用 checkValid("write")，文件句柄无效或不可写时直接返回。通过检查后，它调用内部的 readFrom，并接收 n、handled 和 err 三个结果。

func (f *File) ReadFrom(r io.Reader) (n int64, err error) {
    if err := f.checkValid("write"); err != nil {
        return 0, err
    }
    n, handled, e := f.readFrom(r)
    if !handled {
        return genericReadFrom(f, r)
    }
    return n, f.wrapErr("write", e)
}

handled=false 的含义是“这次内部尝试没有接管”，不是失败。此时标准库转到 genericReadFrom，继续用通用方式读取并写入。Linux、Solaris 和其他平台的内部实现还可能不同，文章里的结论应停留在这个稳定的分支语义上，不要依赖某一台机器一定出现某个内核调用。

用偏移和返回值判断复制是否真的完成

排查“文件变小”时，先不要只看耗时。ReadFrom 返回的 n 是写入的字节数，err 是这次复制遇到的错误；文件当前偏移则反映下一次写入会从哪里继续。可以用一个可复现的小测试记录三者：

before, _ := dst.Seek(0, io.SeekCurrent)
n, err := dst.ReadFrom(strings.NewReader("hello"))
after, seekErr := dst.Seek(0, io.SeekCurrent)

fmt.Printf("n=%d err=%v before=%d after=%d seekErr=%v\n",
    n, err, before, after, seekErr)

对一个打开后偏移为 0 的普通文件，正常结果应是 n=5、err=nil，偏移从 0 移到 5。不要把 io.EOF 当成“少写了一次”：Reader 的结束语义由读取循环处理，真正需要警惕的是返回字节数不足且同时带有非空错误，或目标写入遇到磁盘、权限等错误。

短写错误怎么留证和恢复

自定义 Reader 或 Writer、管道以及底层存储异常都可能让一次复制提前停止。业务代码至少应保留 n 和 err，必要时再用 Stat 检查文件大小；不要因为“文件已经创建”就把这次操作标记为成功。

• 完整写入：err == nil，并且 n 与输入长度或已知期望长度一致。
• 可重试的中断：保存临时文件和 n，确认输入是否可从同一位置继续，再决定重试；不能无条件从头追加。
• 不可恢复错误：保留原始错误和临时文件路径，清理动作应与业务状态更新分开，避免把失败文件当成正式产物。

如果目标文件使用了 O_APPEND，偏移与追加位置的关系还要结合打开标志理解；如果通过 Seek 改过位置，测试时应把“预期写入点”记录下来。并发使用同一个 *os.File 虽然方法层面是安全的，但多个写入者的业务顺序仍需要自己定义。

常见问题：ReadFrom 的边界判断

io.Copy 一定会使用 ReadFrom 吗？

只有目标实现了 io.ReaderFrom 且调用路径没有被其他包装层改变时，才会优先走这个接口。即使没有走到，io.Copy 仍可回退到通用复制。

handled=false 是否等于快速路径失败？

不是。它表示内部专用实现没有接管，标准库会继续执行 genericReadFrom。最终结果仍要看 n 与 err。

只检查文件大小够不够？

不够。大小只能说明当前可见长度，不能替代复制返回值和错误；对预分配、追加或并发写入的文件，还要结合偏移与打开标志。

收尾检查

把 os.File.ReadFrom 当作一条有分支的写入链路来理解，排查就会清楚很多：先确认 io.Copy 是否进入 ReadFrom，再看 readFrom 是否 handled，最后用 n、err、偏移和文件大小交叉验收。专用路径是否出现是实现细节，完整性和错误处理才是应用真正要守住的边界。