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

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 挂载点)。
可控优化方式:
立即学习“go语言免费学习笔记(深入)”;
- 显式使用
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
io.Copy 不校验数据完整性,也不保证原子性**。复制中途崩溃,目标文件就是半截垃圾。真要可靠,得自己加 checksum 或用 os.Rename 配合临时文件。










