io.copy仅流式搬运字节,不处理目录创建、元数据保留、原子性及内存控制;需手动mkdir、open/create文件、close资源,并用bufio优化大文件复制。

用 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 一个都不管。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











