答案：通过封装io.Reader实现Golang文件上传下载进度显示。上传时用带计数的Reader包装文件流，结合multipart发送并实时计算已读字节；下载时用TeeReader或自定义Reader在写入文件时统计接收量；可通过回调或channel传递进度提升灵活性；需注意atomic操作保证并发安全、避免频繁输出、处理Content-Length为-1的情况，适用于大文件场景。
在使用 Golang 进行文件上传和下载时，实现进度显示可以提升用户体验，尤其是在处理大文件时。虽然标准库没有直接提供进度跟踪功能，但可以通过封装底层的读写操作来实时统计已传输的数据量，从而实现进度管理。
1. 文件上传进度显示
上传进度的核心是在客户端读取文件并发送 HTTP 请求时，通过一个带计数的 io.Reader 包装原始数据流，实时报告已读取的字节数。
示例：使用 multipart/form-data 上传文件并显示进度：
func uploadFileWithProgress(filePath, url string) error {
file, err := os.Open(filePath)
if err != nil {
return err
}
defer file.Close()
fileInfo, _ := file.Stat()
totalSize := fileInfo.Size()
// 创建带进度的读取器
progressReader := &progressReader{file: file, totalSize: totalSize}
// 创建 multipart 请求体
var body bytes.Buffer
writer := multipart.NewWriter(&body)
part, _ := writer.CreateFormFile("upload", filepath.Base(filePath))
io.Copy(part, progressReader)
writer.Close()
// 发送请求
req, _ := http.NewRequest("POST", url, &body)
req.Header.Set("Content-Type", writer.FormDataContentType)
client := &http.Client{}
resp, err := client.Do(req)
if resp != nil {
defer resp.Body.Close()
}
return err}
立即学习“go语言免费学习笔记（深入）”；
// 带进度的读取器
type progressReader struct {
file *os.File
totalSize int64
bytesRead int64
}
func (pr *progressReader) Read(p []byte) (n int, err error) {
n, err = pr.file.Read(p)
atomic.AddInt64(&pr.bytesRead, int64(n))
// 打印进度（可替换为回调或 channel）
fmt.Printf("上传进度: %.2f%%\n", float64(pr.bytesRead)/float64(pr.totalSize)*100)
return n, err}
立即学习“go语言免费学习笔记（深入）”；
2. 文件下载进度显示
下载进度更简单，只需在接收响应 Body 时，用 io.TeeReader 或自定义 Reader 包装，边写入文件边统计进度。
示例：下载文件并显示进度：
func downloadFileWithProgress(url, savePath string) error {
resp, err := http.Get(url)
if err != nil {
return err
}
defer resp.Body.Close()
file, err := os.Create(savePath)
if err != nil {
return err
}
defer file.Close()
totalSize := resp.ContentLength
bytesRead := int64(0)
reader := &progressReaderDL{
Reader: resp.Body,
totalSize: totalSize,
bytesRead: &bytesRead,
}
_, err = io.Copy(file, reader)
return err}
立即学习“go语言免费学习笔记（深入）”；
type progressReaderDL struct {
io.Reader
totalSize int64
bytesRead *int64
}
func (pr *progressReaderDL) Read(p []byte) (n int, err error) {
n, err = pr.Reader.Read(p)
atomic.AddInt64(pr.bytesRead, int64(n))
if pr.totalSize > 0 {
percent := float64(*pr.bytesRead) / float64(pr.totalSize) * 100
fmt.Printf("下载进度: %.2f%%\n", percent)
}
return n, err}
立即学习“go语言免费学习笔记（深入）”；
3. 使用回调或 Channel 提升灵活性
上述例子直接打印进度，实际项目中建议使用回调函数或 channel 将进度传递给 UI 层或其他模块。
例如定义回调类型：
type ProgressCallback func(bytesRead, totalBytes int64)
然后在 Read 方法中调用 callback，实现解耦。
4. 注意事项
进度显示虽小，但有几个关键点需要注意：
- 使用 atomic 操作保证多 goroutine 下计数安全
- 避免频繁输出日志，可设置阈值（如每 1% 更新一次）
- 下载时 Content-Length 可能为 -1（流式无头），需做判断
- 上传进度依赖客户端主动读取，服务端无法控制
基本上就这些。通过包装 Reader 实现进度监控，是 Go 中轻量且通用的做法。不复杂但容易忽略细节。
