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

本文深入解析了Go语言中io.Copy函数在文件复制场景下的正确用法与常见误区：它并非直接支持路径字符串的“一键复制”工具，而是专为流式数据传输设计的底层接口，必须配合os.Open和os.Create（或os.OpenFile）手动获取io.Reader和io.Writer实例；文章不仅给出了带完整错误处理的最小可行代码，还强调了defer及时关闭文件、权限位不会自动继承、大文件复制的资源特性及跨平台路径兼容性等关键细节，帮助开发者避开隐晦坑点，写出健壮可靠的文件拷贝逻辑。

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相关知识，快来关注吧！