Go语言io.Copy复制文件详解

本文深入解析了Go语言中io.Copy函数复制文件的正确用法与常见误区，明确指出io.Copy本身不支持直接传入文件路径，必须通过os.Open和os.Create（或os.OpenFile）分别获取符合io.Reader和io.Writer接口的文件句柄后才能使用；文章不仅提供了带完整错误处理和资源管理（defer关闭）的最小可用示例，还强调了缓冲机制、大文件复制的注意事项、跨系统兼容性、Windows路径处理，以及极易被忽视的关键细节——目标文件默认权限不会继承源文件，需手动调用os.Chmod配合FileInfo.Mode()进行保留，帮助开发者写出健壮、可移植且符合生产要求的文件复制逻辑。

io.Copy 不能直接复制文件，它只复制数据流；要复制文件，必须手动打开源和目标文件，再用 io.Copy 中转。

为什么不能直接 io.Copy("a.txt", "b.txt")

因为 io.Copy 的签名是 func Copy(dst Writer, src Reader) (written int64, err error)，它只接受实现了 io.Reader 和 io.Writer 接口的值，比如 *os.File，而不是字符串路径。传入字符串会编译报错：cannot use "a.txt" (type string) as type io.Reader。

• 常见错误：把文件路径当 Reader/Writer 直接传给 io.Copy
• 正确做法：先用 os.Open 打开源文件（得 io.Reader），再用 os.Create 或 os.OpenFile 创建目标文件（得 io.Writer）
• 注意：os.Create 会截断已有文件，如果想保留原文件权限或支持追加，得用 os.OpenFile 配合 os.O_CREATE | os.O_WRONLY 等标志

最简可用的复制实现（带错误处理）

以下代码能完成基本复制，且覆盖了常见边界情况：

src, err := os.Open("source.txt")
if err != nil {
    log.Fatal(err)
}
defer src.Close()

dst, err := os.Create("dest.txt")
if err != nil {
    log.Fatal(err)
}
defer dst.Close()

_, err = io.Copy(dst, src)
if err != nil {
    log.Fatal(err)
}

• defer 关闭文件很重要，否则可能泄漏文件描述符，尤其在循环复制多个文件时容易出问题
• io.Copy 内部已做缓冲（默认 32KB），无需自己包装 bufio.Reader 或 bufio.Writer
• 返回的 written 是实际字节数，可用于校验（比如对比 os.Stat 得到的源文件大小）

复制大文件时要注意什么

虽然 io.Copy 自带缓冲，但对 GB 级文件仍需关注资源行为：

• 内存占用不会随文件变大而线性增长，因为它是流式读写，但 OS 层的 page cache 可能升高
• 若需进度提示，可包装一个自定义 io.Reader，在 Read 方法里更新计数器并回调通知
• 跨文件系统复制（如从 SSD 到 NFS）时，io.Copy 仍是可靠选择；不要尝试用 os.Link 或 os.Rename 替代，它们不保证跨设备成功
• Windows 下注意路径分隔符——os.Open 能自动处理 "a/b.txt"，无需手动转 "a\\b.txt"

真正容易被忽略的是：复制后目标文件的权限位默认是 0666 &^ umask，和源文件无关；如果需要保留权限（包括可执行位），得额外调用 os.Chmod，读取源文件的 FileInfo.Mode() 后设置过去。

本篇关于《Go语言io.Copy复制文件详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！