当前位置：首页 > 文章列表 > Golang > Go教程 > Golangio.Copy文件复制教程详解

Golangio.Copy文件复制教程详解

2026-01-17 08:39:37 0浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Golang io.Copy复制文件与流教程》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

io.Copy 复制为空文件因未正确打开目标文件或源已到 EOF；须用 os.O_CREATE | os.O_WRONLY | os.O_TRUNC 打开目标，检查 io.Copy 返回的 n > 0 且 err == nil；大文件复制应先定位 I/O 瓶颈，再考虑用 io.CopyBuffer 自定义缓冲区。

如何使用Golang io.Copy复制文件与流_Golang io Copy示例

io.Copy 复制文件时为什么总是空文件？

因为 io.Copy 不会自动关闭目标文件，也不处理源文件读取失败后的状态。常见错误是打开目标文件用了 os.O_CREATE 但没加 os.O_WRONLY 或 os.O_TRUNC，导致写入失败却无报错。更隐蔽的问题是：源文件句柄已到 EOF（比如被其他 goroutine 读过一遍），io.Copy 立即返回 0, nil，看起来“复制成功”实则没写入任何内容。

正确做法：

源文件必须以只读方式打开，且确保 Seek(0, 0) 可用（如需多次复制）
目标文件必须用 os.O_CREATE | os.O_WRONLY | os.O_TRUNC 打开
io.Copy 返回的 n, err 必须检查：err == nil 且 n > 0 才算有效复制

复制大文件时内存占用高怎么办？

io.Copy 默认使用 io.CopyBuffer 内部的 32KB 缓冲区，对 GB 级文件足够，但若遇到 I/O 延迟高或磁盘吞吐低的环境，小缓冲会导致系统调用频繁、CPU 耗高。此时不应盲目增大缓冲区，而应优先确认瓶颈是否在磁盘或文件系统（如 NFS 挂载点）。

可控优化方式：

显式使用 io.CopyBuffer(dst, src, make([]byte, 1 设置 1MB 缓冲（注意：不能超过 1GB，否则分配失败）
避免在循环中反复调用 io.Copy 复制多个小文件——改用 os.ReadDir + 单次 os.OpenFile 批量处理
对 SSD 本地文件，32KB ~ 128KB 缓冲通常最优；对机械盘或网络存储，可试 512KB

复制 HTTP 响应体到文件为何常出 “use of closed network connection”？

典型场景是用 http.Get 获取资源后，直接把 resp.Body 传给 io.Copy，但忘记 defer resp.Body.Close() ——看似没问题，实则当 io.Copy 遇到网络中断或服务端提前断连时，底层连接会被关闭，后续再读就会触发该错误。

安全写法必须包含三要素：

用 context.WithTimeout 控制请求生命周期
io.Copy 后立即 resp.Body.Close()（不能 defer，因为要等 copy 完）
检查 io.Copy 返回的 err：若为 net.ErrClosed 或 io.ErrUnexpectedEOF，说明传输不完整

resp, err := http.DefaultClient.Do(req)
if err != nil {
    return err
}
defer resp.Body.Close() // 注意：这是对 resp 的 defer，不是对 Body 的

f, err := os.Create("out.bin")
if err != nil {
    return err
}
defer f.Close()

n, err := io.Copy(f, resp.Body)
if err != nil && err != io.EOF {
    return fmt.Errorf("copy failed: %w", err)
}
if n == 0 {
    return errors.New("no bytes copied, check HTTP status or network")
}

用 io.Copy 处理管道或标准输入时要注意什么？

从 os.Stdin 或 os.Pipe 复制数据时，io.Copy 会在读到 EOF 后自然退出，但容易忽略两点：一是 os.Stdin 在终端中按 Ctrl+D 才发 EOF，脚本中若期望“读完就停”，需配合 bufio.Scanner；二是管道写端未关闭前，io.Copy 会一直阻塞。

典型陷阱：

子进程通过 cmd.StdoutPipe() 获取 reader，但父进程未调用 cmd.Wait()，导致 pipe 写端悬空，io.Copy 永不返回
用 io.Copy(ioutil.Discard, r) 丢弃流时，若 r 是带超时的 net.Conn，可能因读超时返回 net.OpError，需区分处理
Linux 下从 /dev/stdin 复制时，若输入来自重定向（./a ），io.Copy 行为正常；但若来自管道（echo x | ./a），某些 shell 会提前关闭 fd，需加 os.Stdin.Stat() 判断是否为 pipe