Go语言用io.Copy复制文件教程

本文深入解析了Go语言中使用io.Copy复制文件的正确方法与常见误区，强调io.Copy仅支持io.Reader和io.Writer接口（如*os.File），无法直接传入字符串路径；必须先用os.Open和os.Create（或os.OpenFile）显式打开源文件和目标文件，再通过io.Copy流式中转数据。文章不仅给出了带完整错误处理的最小可用示例，还提醒了defer关闭文件的重要性、默认缓冲机制的优势、大文件复制时的资源考量、跨平台路径兼容性，以及极易被忽视的关键细节——目标文件权限不会自动继承源文件，需手动调用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学习网公众号了解相关技术文章。