Vue中实时监听文件上传进度的核心是Axios的onUploadProgress配置项,它基于浏览器原生ProgressEvent事件流,非轮询;需判断lengthComputable为true后用loaded/total计算百分比,并用响应式数据绑定显示。

Vue 中实时监听文件上传进度百分比,核心是利用 Axios 的 onUploadProgress 配置项,配合前端对 ProgressEvent 的解析。它不是轮询或定时器,而是浏览器原生支持的上传事件流,响应及时、开销低。
基础实现:单文件 + Axios 原生监听
这是最轻量、无需额外库的方案,适合中小文件和简单场景:
- 用
FormData包裹文件,确保Content-Type由浏览器自动设置(不要手动设为multipart/form-data,否则可能出错) - 在 Axios 请求配置中传入
onUploadProgress回调函数,它接收原生ProgressEvent - 通过
progressEvent.loaded和progressEvent.total计算百分比,注意需判断lengthComputable === true才可信 - 在 Vue 组件中用响应式数据(如
uploadPercent)绑定该值,模板中直接显示或传给进度条组件
进阶处理:多文件 & 进度独立追踪
用户同时选多个文件时,不能共用一个进度值。需要为每个上传任务分配唯一标识,并分别管理:
- 上传前为每个
File对象生成 ID(推荐用URL.createObjectURL(file)或file.lastModified + file.name拼接,避免Symbol()在跨组件时丢失) - 用
Ref(Vue3)或data对象(Vue2)维护一个映射表,如{ fileId: { percent: 0, loaded: 0, total: file.size } } - 每次调用
axios.post时,把当前文件 ID 闭包进onUploadProgress回调里,只更新对应条目 - 模板中用
v-for渲染每个文件的进度条,绑定各自percent
稳定增强:分片上传下的真实进度计算
大文件(如 >100MB)建议走分片上传。此时 onUploadProgress 只反映单个分片的进度,需手动聚合:
立即学习“前端免费学习笔记(深入)”;
- 提前记录总文件大小
file.size,所有分片上传完成后才真正完成 - 每上传完一个分片,累加其字节数(例如:已成功上传 5 个 4MB 分片 → 已传 20MB)
- 整体进度 =
Math.round((uploadedBytes / file.size) * 100),而非依赖某次请求的progressEvent.total(它只是当前分片大小) - 可选用
vue-simple-uploader或封装好的组合式函数(如useChunkedUpload),内部已处理分片队列、重试、断点续传和聚合进度逻辑
兼容与降级:应对 total === 0 或旧浏览器
部分环境(如某些 Safari 版本、代理后端未透传 Content-Length)会导致 progressEvent.total === 0,无法算百分比:
- 检测到
!progressEvent.lengthComputable或progressEvent.total === 0时,改用状态提示,如“正在连接…”、“传输中…” - 可结合上传耗时估算:每秒平均速率 × 已用时间,粗略反推剩余量(非精确但体验更友好)
- 服务端若支持
Content-Range或返回分片总数,可在上传前先发一次HEAD请求预获取元信息


















