Go语言通过后端接口支持上传进度，前端利用HTML5事件监听、分片上传查询、第三方协议或实时推送实现进度显示。
Go语言本身不直接提供前端上传进度功能，因为进度显示主要依赖前端技术配合后端支持。但Golang可以通过后端接口设计和中间件机制，为文件上传进度的实现提供数据支撑。要实现Web表单上传进度显示，通常采用以下方式：
1. 使用HTML5 + JavaScript（如Ajax或Fetch）监听上传事件
浏览器原生支持通过XMLHttpRequest.upload.onprogress事件获取上传进度。
示例前端代码：
const form = document.getElementById('uploadForm');
form.addEventListener('submit', function(e) {
e.preventDefault();
const fileInput = document.getElementById('file');
const file = fileInput.files[0];
const formData = new FormData();
formData.append('file', file);
const xhr = new XMLHttpRequest();
xhr.upload.onprogress = function(e) {
if (e.lengthComputable) {
const percent = (e.loaded / e.total) * 100;
console.log(上传进度: ${percent.toFixed(2)}%);
// 更新进度条
document.getElementById('progress').style.width = percent + '%';
}
};
xhr.open('POST', '/upload');
xhr.send(formData);
});
这种方案中，Golang只需正常处理multipart/form-data请求，无需特殊逻辑即可让前端监听进度。
立即学习“go语言免费学习笔记（深入）”；
2. 大文件分片上传 + 后端进度查询接口
对于大文件，可将文件切片上传，并用唯一ID标识整个上传任务。Golang后端记录每个分片的接收状态，前端轮询查询进度。
关键步骤：
- 前端生成上传ID，每片带上id和序号上传
- Golang服务收到分片后存入临时目录，并更新该ID的已接收片数
- 提供/progress/:upload_id接口返回当前完成比例
- 前端定时请求该接口更新UI
此方法能精确控制进度，适合GB级文件上传场景。
3. 使用第三方库跟踪上传状态（如tus、gcp-resumable-upload）
tus是一个开源的断点续传协议，Golang有对应实现（如github.com/tus/tusd），支持进度查询、断点续传、跨设备上传等高级功能。
使用示例：
composer := tusd.DefaultComposer()
handler, _ := tusd.NewHandler(tusd.Config{
StoreComposer: composer,
BasePath: "/files/",
})
http.Handle("/files/", http.StripPrefix("/", handler))
前端使用tus-js-client连接，自动获得上传进度回调。
4. 实时进度推送（WebSocket或Server-Sent Events）
在接收文件的同时，通过SSE或WebSocket主动推送进度给前端。
例如，在Multipart读取过程中发送进度：
reader, _ := r.MultipartReader()
var total, read int64
for part, _ := reader.NextPart(); part != nil; part, _ = reader.NextPart() {
buffer := make([]byte, 1024)
for {
n, err := part.Read(buffer)
read += int64(n)
// 通过channel或SSE发送进度
sendProgress(uploadID, float32(read)/float32(total))
if err == io.EOF {
break
}
}
}
需结合context或goroutine管理生命周期，避免阻塞HTTP请求。
基本上就这些。Golang不做前端渲染，重点在于提供稳定上传接口和进度数据源。选择哪种方案取决于文件大小、用户体验要求和系统复杂度。小文件用第一种就够了，大文件建议上分片或tus协议。
