Pinia 的 Actions 是处理异步请求最自然、最推荐的位置，支持 async/await、统一错误处理、配套 loading/error/data 状态管理、API 调用需封装、可选 AbortController 取消请求、$onAction 实现无侵入监控。
Pinia 的 Actions 是处理异步请求最自然、最推荐的位置。它不强制异步，但完整支持 async/await，能把请求发起、状态更新、错误反馈和副作用控制全部收束在一个函数里，逻辑清晰、调试方便、测试友好。
用 async/await 统一编写，避免混用 .then()
所有涉及接口调用的 Action 都应声明为 async 函数，并统一用 await 等待 Promise 完成。混用 .then() 会导致错误捕获断裂、堆栈难追踪，也不利于后续维护。
- 同步逻辑（如表单校验、本地计算）可直接写，不用加
async - 异步 Action 默认返回 Promise，组件调用时需
await或.then()处理结果 - 不要在同一个 Action 里既写
await api.get()又写api.post().then(...)
配套管理 loading、error、data 状态
在 Store 中定义响应式字段，让组件能直观反映请求生命周期：
-
loading: boolean —— 请求发起时设为
true，结束（无论成功失败）设为false -
error: string | null —— 存用户友好的错误提示，比如
err.response?.data?.message - data（或具体字段如 user、list） —— 成功后赋值，避免空值渲染异常
API 调用必须抽离到独立模块
Action 内不应出现 axios.get() 或 fetch() 原始调用，而应调用封装好的 API 函数：
- 示例路径：
src/api/user.ts导出getUser(id: string) - Action 内只写：
const res = await getUser(id) - 好处：拦截器、鉴权头、Mock 开关、类型自动推导全由 API 层统一管控
- 便于单元测试 —— 可直接 mock API 模块，无需启动真实服务
高频场景下主动取消请求（可选但推荐）
对搜索、输入联想、频繁切换等场景，用 AbortController 避免响应错乱：
- 每次请求前新建
const controller = new AbortController() - 传入
signal: controller.signal到 API 调用中 - 新请求发起时调用
controller.abort()，终止上一个未完成请求
用 $onAction 做统一监控和增强
不侵入业务代码，也能实现日志、错误上报、全局 loading 计数：
- before 阶段：记录起始时间、设置 loading 计数器
- after 阶段：获取返回值，统计耗时并打点
-
onError 阶段：同时捕获同步
throw和异步reject，按 action 名称或错误码分级处理 - 组件内订阅默认随卸载自动清理；全局长效监控需传
{ detached: true }并手动管理销毁
