Golang复制文件方法及io.Copy使用教程

一分耕耘，一分收获！既然打开了这篇文章《Golang复制文件方法及io.Copy示例》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

io.Copy 是最常用且稳妥的文件复制方式，自动处理缓冲、分块读写和错误传播，适合任意大小文件；但不保留权限、时间戳等元信息，需手动调用 os.Chmod 和 os.Chtimes 补全。

用 io.Copy 复制文件是最常用也最稳妥的方式

Go 标准库的 io.Copy 是专为流式拷贝设计的，底层自动处理缓冲、分块读写和错误传播，比手动 Read/Write 更安全、更高效。它不关心数据内容，只负责把一个 io.Reader 的所有字节完整送到 io.Writer，适合任意大小的文件（包括超大文件）。

常见错误是直接用 os.ReadFile + os.WriteFile —— 这会把整个文件一次性加载进内存，对 GB 级文件极易 OOM。

• 必须确保源文件存在且可读，目标目录已存在（io.Copy 不创建父目录）
• 目标文件若已存在，会被直接覆盖（无提示）
• 复制后不会保留原文件的权限、时间戳等元信息——这是 io.Copy 的预期行为，不是 bug

func copyFile(src, dst string) error {
	srcFile, err := os.Open(src)
	if err != nil {
		return err
	}
	defer srcFile.Close()

	dstFile, err := os.Create(dst)
	if err != nil {
		return err
	}
	defer dstFile.Close()

	_, err = io.Copy(dstFile, srcFile)
	return err
}

需要保留文件权限和 ModTime？得手动设置 os.FileInfo

io.Copy 只管字节流，不碰文件系统元数据。如果要让目标文件和源文件权限一致（比如可执行位）、修改时间一致，得额外调用 os.Chmod 和 os.Chtimes。

• 权限需从 os.Stat 获取 Mode()，再传给 os.Chmod
• 时间戳要用 os.Chtimes(dst, info.ModTime(), info.ModTime())，第二个参数是访问时间，第三个是修改时间
• 注意：Windows 下 Chmod 对权限位的支持有限，部分位会被忽略

func copyFileWithMeta(src, dst string) error {
	srcFile, err := os.Open(src)
	if err != nil {
		return err
	}
	defer srcFile.Close()

	dstFile, err := os.Create(dst)
	if err != nil {
		return err
	}
	defer dstFile.Close()

	_, err = io.Copy(dstFile, srcFile)
	if err != nil {
		return err
	}

	info, err := os.Stat(src)
	if err != nil {
		return err
	}

	err = os.Chmod(dst, info.Mode())
	if err != nil {
		return err
	}

	return os.Chtimes(dst, info.ModTime(), info.ModTime())
}

复制大文件时卡住？检查是否遗漏 Close 或用了阻塞 I/O

典型现象是程序在 io.Copy 调用处长时间无响应，但 CPU 占用低、磁盘无读写。这往往不是 io.Copy 本身的问题，而是上游或下游的 I/O 被阻塞：

• 源文件被其他进程独占锁定（如 Windows 上用资源管理器打开着 txt 文件）→ os.Open 会成功，但 io.Copy 读不到数据
• 目标路径是网络挂载盘（NFS/SMB），且连接不稳定 → Write 调用可能挂起数分钟
• 忘记 defer file.Close()，导致文件句柄泄漏，后续操作失败
• 用 os.OpenFile(dst, os.O_CREATE|os.O_WRONLY, 0) 但没设权限掩码（第三个参数为 0）→ 创建的文件不可读，后续操作报错

想并发复制多个文件？别直接开 goroutine 调 io.Copy

多个 io.Copy 并发跑本身没问题，但要注意资源竞争点：

• 如果目标目录相同，多个 os.Create 可能互相覆盖，且无原子性保障
• 大量并发读同一块 SSD/NVMe 盘，反而因随机 IO 降低吞吐；顺序读+单 goroutine 通常更快
• 真正瓶颈常在磁盘或网络，而非 CPU —— 开 10 个 goroutine 不一定比 2 个快
• 若需进度反馈，不要在 io.Copy 内部加锁更新全局变量，改用 io.MultiWriter 或封装带回调的 reader

元数据同步、错误聚合、限速控制这些事，io.Copy 一律不管——得自己补全逻辑，不是加个 go 就万事大吉。

好了，本文到此结束，带大家了解了《Golang复制文件方法及io.Copy使用教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！