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

本文深入解析了Go语言中使用`io.Copy`复制文件的实用技巧与常见陷阱：它虽能高效流式搬运字节，但绝不“开箱即用”——既不自动创建目标目录、不保留文件权限与时间戳，也不保障原子性或内存安全；实际应用中必须手动处理路径创建、文件打开/关闭、缓冲优化及元数据同步，尤其在大文件或生产环境中，忽略这些细节极易导致崩溃、数据不一致或性能瓶颈。

用 io.Copy 复制文件是可行的，但直接拿来就用容易出错——它不处理文件元信息、不保证原子性、遇到大文件可能吃光内存（如果底层 Reader 没缓冲），更关键的是：它不创建目标目录。

为什么 io.Copy 不能直接复制文件

io.Copy 只做流式数据搬运，它不管源是不是文件、目标存不存在、路径该不该 mkdir。你传两个 *os.File 给它，它就从第一个读、往第二个写，仅此而已。

常见错误现象：open /path/to/dest: no such file or directory —— 其实不是 io.Copy 报的，而是你打开目标文件时失败了。

• 必须自己调用 os.Open 和 os.Create（或 os.OpenFile）准备好句柄
• 目标路径的父目录得提前存在，io.Copy 不会帮你 os.MkdirAll
• 复制后不会保留 modtime、权限（chmod）、属主等元数据

怎么安全地用 io.Copy 复制单个文件

核心是补足 io.Copy 不干的三件事：建目录、开文件、关资源。别信“一行复制”的示例代码。

• 用 filepath.Dir(destPath) 提取父路径，再用 os.MkdirAll 创建
• 用 os.Open(srcPath) 打开源，os.Create(destPath) 创建目标（注意：后者会 truncate 已有文件）
• 复制完务必 Close() 两个文件，建议用 defer 或 errgroup 管理
• 检查 io.Copy 返回的 n, err：即使 err == nil，也要确认 n 是否等于源文件大小（可选，适合关键场景）

简短示例：

src, _ := os.Open("a.txt")
defer src.Close()
dst, _ := os.Create("dir/b.txt") // 注意 dir 必须已存在
defer dst.Close()
io.Copy(dst, src) // 这行才真正搬运数据

复制大文件时为什么卡住或 OOM

io.Copy 默认用 32KB 缓冲区，看似合理，但如果你传入的 Reader 是没缓冲的（比如直接 os.Open 后未包装），在某些系统上可能触发大量小 read 系统调用；更糟的是，若目标 Writer 是网络句柄或慢盘，io.Copy 会阻塞在 write，而内存里积压的未写数据可能撑爆 heap。

• 对大文件（>100MB），显式用 bufio.NewReaderSize 和 bufio.NewWriterSize 包装，把缓冲设到 1MB 左右
• 避免把 io.Copy 塞进 goroutine 后不管——它不自动 cancel，出错也不会中断
• Linux 下注意 /proc/sys/vm/dirty_ratio，过高的脏页比例会让 write 阻塞更久

想保留权限和时间戳？别只靠 io.Copy

io.Copy 只动内容，不动文件头。要真正“复制文件”，还得补操作：

• 用 os.Stat(srcPath) 获取 os.FileInfo，再用 os.Chmod(destPath, fi.Mode())
• 用 os.Chtimes(destPath, fi.ModTime(), fi.ModTime()) 同步时间戳
• 注意：Windows 不支持 uid/gid，Chown 在多数场景可跳过
• 如果目标文件系统是 NFS 或 FUSE，Chmod 可能静默失败，建议检查返回 err

元数据这事没法偷懒，io.Copy 就是纯粹的字节管道——它可靠，也仅此而已。

真正麻烦的从来不是复制那几行代码，而是判断要不要递归、要不要跳过 symlink、目标磁盘剩多少空间、用户有没有权限写父目录……这些 io.Copy 一个都不管。

终于介绍完啦！小伙伴们，这篇关于《Go语言io.Copy复制文件使用教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！