ref 管理页面加载状态的核心是使 loading 变量具备响应式能力,并在请求生命周期中精准控制其值;它轻量直接,适合局部或中低复杂度场景,支持按钮级独立控制、工具函数封装及请求拦截器透传式管理。

用 ref 管理页面加载状态,核心是让 loading 变量具备响应式能力,并在请求生命周期中精准控制其值。它轻量、直接、不依赖额外状态库,特别适合局部或中低复杂度场景。
直接用 ref 控制按钮级 loading
适用于单个操作(如提交表单、刷新列表),每个按钮有自己独立的 loading 状态:
- 在
setup中声明const btnLoading = ref(false) - 调用 API 前设为
true,完成后(无论成功失败)设回false - 模板中绑定到
<el-button :loading="btnLoading"></el-button>或<a-button :loading="btnLoading"></a-button>
示例逻辑:
const btnLoading = ref(false)
const handleSubmit = async () => {
btnLoading.value = true
try {
await api.submitForm(data.value)
ElMessage.success('提交成功')
} catch (err) {
ElMessage.error('提交失败')
} finally {
btnLoading.value = false
}
}封装 withLoading 工具函数复用逻辑
避免每个点击事件都写重复的 try/finally:
立即学习“前端免费学习笔记(深入)”;
- 定义一个通用函数,接收 Promise,自动处理 loading 开关
- 支持可选延迟(比如
import { ref } from 'vue'
export function withLoading<T>(promise: Promise<T>, delay = 0) {
const loading = ref(false)
let timer: NodeJS.Timeout | null = null
if (delay > 0) {
timer = setTimeout(() => (loading.value = true), delay)
} else {
loading.value = true
}
return promise
.finally(() => {
if (timer) clearTimeout(timer)
loading.value = false
})
.then(res => {
if (timer) clearTimeout(timer)
return res
})
}组件内使用:
const btnLoading = ref(false)
const handleClick = async () => {
await withLoading(api.fetchList(), 300).then(res => {
list.value = res.data
})
}模板中仍绑定 :loading="btnLoading",函数内部已接管开关。
ref 配合请求拦截器实现「透传式」局部 loading
当封装了 axios 实例时,可让每个请求携带自己的 loading 引用:
- 请求拦截器检测
config.loading,若为 ref,则设.value = true - 响应/错误拦截器同样检测并设
.value = false - 组件调用时传入
loading: ref(false),无需手动开关
关键点:
- 必须传
ref(true),不能传true(否则不是响应式) - 拦截器只读写
.value,不创建或销毁 ref - 多个按钮可共用同一封装函数,互不影响
例如:
// api/user.ts
export const updateUser = (id: number, data: any) =>
request.put(`/user/${id}`, data, { loading: btnLoading })
// 组件中
const btnLoading = ref(false)
await updateUser(1, { name: '张三' }) // 自动触发 loading 开关注意事项:防止 loading 卡死
常见原因和对策:
- 请求抛出未捕获异常,导致
finally不执行 → 始终用try/catch/finally或.finally() - API 返回 4xx/5xx,但只在
.then()里重置 loading → 错误分支也要重置 - 使用
await但没包在异步函数里 → 确保调用上下文是async函数 - 多次快速点击触发多个请求,但 loading 只有一个 → 每个操作用独立 ref,或改用计数器方案
不复杂但容易忽略


















