如何使用Golang复制文件_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 被阻塞：

立即学习“go语言免费学习笔记（深入）”；

源文件被其他进程独占锁定（如 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 就万事大吉。

# go # windows # golang # 字节 # 资源管理器 # win # 标准库 # 封装 # 全局变量 # copy # 并发 # bug # 多个 # 第三个 # 最常用 # 这是 # 句柄 # 万事大吉 # 用了 # 第二个 # 要用 # 更快

相关栏目：【 Google疑问12 】【 Facebook疑问10 】【网络优化76771 】【技术知识130152 】【 IDC云计算60162 】【营销推广131313 】【 AI优化88182 】【百度推广37138 】【网站推荐60173 】【精选阅读31334 】

2026-01-02

4007654355

如何使用Golang复制文件_Golang io Copy文件拷贝示例

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

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

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

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

了解您产品搜索量及市场趋势，制定营销计划

同行竞争及网站分析保障您的广告效果

提交您的需求，1小时内享受我们的专业解答。

致胜网络推广营销网

4007654355

服务/方案/案例/支持

关于我们

Notice

4007654355

如何使用Golang复制文件_Golang io Copy文件拷贝示例

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

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

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

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

了解您产品搜索量及市场趋势，制定营销计划

同行竞争及网站分析保障您的广告效果

提交您的需求，1小时内享受我们的专业解答。

致胜网络推广营销网

4007654355

服务/方案/案例/支持

关于我们

Notice

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

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

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

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