可用自定义Writer实现io.Copy进度追踪：实现Write方法累加字节数并回调，避免在Write中执行耗时操作，不依赖os.Stat，禁用io.MultiWriter（因其广播而非代理），采样更新进度，支持断点续传需配合io.CopyN和Seek。
用 io.Copy 配合自定义 Writer 实现进度追踪
Go 标准库的 io.Copy 本身不暴露进度，但它的第二个参数是 io.Writer 接口——这意味着你可以传一个自己写的、带计数逻辑的 Writer，每次写入时更新状态。关键不是重写拷贝逻辑，而是“劫持”写入过程。
常见错误是试图在 io.Copy 外部用 os.Stat 对比源文件大小和已写入字节数，但这在流式场景（比如从网络响应体拷贝）下完全失效，因为源长度未知或不可靠。
- 必须实现
Write([]byte) (int, error)方法，内部累加并触发回调 - 不要在
Write里做耗时操作（如打印、网络请求），否则拖慢整个拷贝 - 如果目标是文件，记得用
os.O_CREATE | os.O_WRONLY | os.O_TRUNC打开，避免追加写导致内容错乱
type ProgressWriter struct {
w io.Writer
total int64
written int64
onWrite func(int64, int64)
}
<p>func (pw *ProgressWriter) Write(p []byte) (n int, err error) {
n, err = pw.w.Write(p)
if n > 0 {
pw.written += int64(n)
pw.onWrite(pw.written, pw.total)
}
return
}为什么不能直接用 io.MultiWriter 套 os.File 和进度回调
io.MultiWriter 是并发写多个 Writer，但它不提供“每次写入多少”的上下文，也无法区分哪个 Writer 写成功了——你没法知道进度回调该基于哪一路数据。它适合日志同时写文件+控制台，不适合进度追踪。
真实场景中，如果你把 ProgressWriter 和 os.File 一起塞进 io.MultiWriter，进度回调会重复触发（因为 MultiWriter.Write 会分别调用每个子 Writer 的 Write），而且数值对不上：ProgressWriter 看到的是原始字节，而 os.File 可能因缓冲、系统调用分片等原因实际落盘节奏不同。
立即学习“go语言免费学习笔记（深入）”；
- 进度必须绑定在“数据真正流向目标”的那个
Write调用上，也就是最终的Writer（如os.File） -
io.MultiWriter不是代理，它是广播器；要代理，就得自己实现Writer - 别依赖
os.File.Stat().Size()当实时进度，它只反映上次Sync()或关闭后的大小
处理大文件时的内存与性能陷阱
io.Copy 默认使用 32KB 缓冲区，这个值在大多数场景下足够平衡内存占用和吞吐。但如果你在 ProgressWriter.Write 里做了同步打印（比如 fmt.Printf），每 32KB 就刷一次屏，1GB 文件会触发 ~32K 次系统调用，严重拖慢速度，甚至让终端卡死。
- 进度回调应做采样：例如只在
written % (1024 * 1024) == 0时通知（即每 MB 更新一次） - 避免在回调里调用
time.Now()或runtime.GC()这类非轻量操作 - 如果目标是网络传输（如 HTTP 响应体），注意
http.ResponseWriter的Write可能返回部分写入（n < len(p)），你的ProgressWriter必须正确处理这种情形，否则进度跳变
如何安全支持中断与恢复（断点续传）
标准 io.Copy 不支持暂停，但你可以用 io.CopyN 分块控制，配合 Seek 实现续传。前提是源和目标都支持随机访问（如本地文件），且你记录了已拷贝的字节数。
容易被忽略的一点是：目标文件必须以 os.O_RDWR 打开，并在开始前用 Seek(0, io.SeekEnd) 定位到末尾，再检查当前大小是否等于预期起始偏移。如果直接 os.O_APPEND，Seek 会失效，后续写入永远在文件末尾，无法覆盖或校验。
- 续传前先
stat目标文件，确认其大小与上次记录一致，否则可能是损坏或被篡改 - 用
io.CopyN(dst, src, n)拷贝固定字节数，比手动循环Read/Write更可靠 - 不要在
ProgressWriter里保存文件句柄或Seek状态——它只负责计数，控制流由外层逻辑管理
进度不是“额外功能”，它是流式 I/O 的可观测性基础。写一个能准确反映字节流动的 Writer 很简单，但让它在各种边界条件下（网络抖动、磁盘满、Ctrl+C 中断）依然给出可信数字，需要仔细处理每个 Write 返回值和错误分支。
