Vue 3 中应使用计数器管理全局加载动画:请求拦截器中计数+1并仅在0→1时显示,响应拦截器中计数−1并仅在1→0时隐藏,结合白名单过滤、Pinia状态封装及统一UI载体确保精准启停。

在 Vue 3 中,请求开始时开启全局加载动画,核心是利用 axios 请求拦截器 捕获每个请求发起的瞬间,并触发 loading 显示逻辑。关键不在于“每次请求都无脑开”,而在于“按需控制”——比如跳过白名单接口、避免重复开启、兼容并发请求。
用计数器管理 loading 状态(推荐)
多个请求可能并发,如果每个请求都 showLoading,又各自 hideLoading,容易出现「loading 提前关闭」或「一直不关」的问题。最稳妥的方式是维护一个请求计数器:
- 请求拦截器里:计数器 +1,若原值为 0,才真正调用
showFullScreenLoading() - 响应拦截器(含 error)里:计数器 -1,若减到 0,才调用
tryHideFullScreenLoading() - 这样即使 3 个请求同时发、响应乱序返回,loading 也能精准控制启停
在请求拦截器中注入 loading 开关逻辑
通常你在创建 axios 实例时配置了 showLoading: true(或通过 config 自定义字段),那么请求拦截器就可据此判断是否启用:
- 检查
config.showLoading !== false,避免某些接口(如轮询、头像上传)误加 loading - 结合白名单/黑名单 URL 过滤,例如:
!['/auth/refresh', '/upload'].includes(config.url) - 不要直接在拦截器里写
showLoading(),而是委托给封装好的计数函数,保持职责清晰
配合 Pinia 或全局状态统一控制
如果你用 Pinia 管理 loading 状态,可在拦截器中 commit mutation 或调用 store 方法:
立即学习“前端免费学习笔记(深入)”;
- 请求拦截器调用
useLoadingStore().start() - 响应拦截器(成功和失败分支)都调用
useLoadingStore().finish() - store 内部仍用计数器,对外暴露简洁 API,组件无需关心细节
- 好处是 loading 状态可被其他逻辑(如路由守卫、手动触发)复用和监听
注意 loading 的实际载体
显示动画本身可以是:
- Element Plus 的
ElLoading.service()全屏遮罩 - Ant Design Vue 的
Spin+ 全局 v-loading 指令 - 纯 CSS 遮罩层(如
.loading-overlay)配合 class 切换 - 无论哪种,都要确保「只存在一个实例」,避免多次 new 实例导致无法关闭


















