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 就万事大吉。
