io.Copy 复制文件简单高效,默认32KB缓冲区流式读写,内存低、性能稳;需确保父目录存在、处理文件覆盖与错误回滚,一般无需自定义缓冲区。

在 Go 中用 io.Copy 复制文件简单高效,尤其适合大文件——它默认使用 32KB 缓冲区流式读写,内存占用低、性能稳定,无需手动管理 buffer 或循环读取。
基础用法:打开源文件和目标文件后直接拷贝
核心就是把两个 io.Reader 和 io.Writer 传给 io.Copy。通常源是 *os.File(实现了 io.Reader),目标也是 *os.File(实现了 io.Writer):
- 用
os.Open打开源文件(只读) - 用
os.Create或os.OpenFile创建/打开目标文件(可写) - 调用
io.Copy(dst, src),返回实际拷贝字节数和可能的错误 - 务必用
defer或显式调用Close()关闭两个文件
处理大文件时的关键细节
io.Copy 本身已针对大文件优化,但还需注意几点避免意外:
- 目标文件路径的父目录必须存在,
os.Create不会自动创建多级目录,可用os.MkdirAll(filepath.Dir(dstPath), 0755)预先确保 - 若目标文件已存在,
os.Create会截断清空内容;如需保留原文件,应先检查是否存在并按需处理 - 拷贝过程中发生错误(如磁盘满、权限不足),
io.Copy会立即返回错误,已写入部分不会自动回滚,业务逻辑需自行决定是否清理临时文件
进阶:自定义缓冲区大小(一般不需要)
io.Copy 内部使用 io.CopyBuffer,默认缓冲区为 32KB(io.DefaultCopyBuffer = 32 * 1024)。绝大多数场景下无需改动,但若明确知道 I/O 特性(如 SSD 随机读写强、网络存储延迟高),可手动指定缓冲区:
立即学习“go语言免费学习笔记(深入)”;
- 用
io.CopyBuffer(dst, src, make([]byte, 64*1024))使用 64KB 缓冲区 - 缓冲区过大可能增加单次系统调用延迟,过小则系统调用频繁;32KB 是经过权衡的通用值
- 除非压测验证有明显提升,否则不建议修改
完整示例代码(含错误处理和资源释放)
以下是一个健壮的文件拷贝函数:
func copyFile(srcPath, dstPath string) error {
src, err := os.Open(srcPath)
if err != nil {
return fmt.Errorf("failed to open source: %w", err)
}
defer src.Close()
// 确保目标目录存在
if err := os.MkdirAll(filepath.Dir(dstPath), 0755); err != nil {
return fmt.Errorf("failed to create parent dir: %w", err)
}
dst, err := os.Create(dstPath)
if err != nil {
return fmt.Errorf("failed to create destination: %w", err)
}
defer dst.Close()
_, err = io.Copy(dst, src)
if err != nil {
return fmt.Errorf("copy failed: %w", err)
}
return nil}










