Vue 3中Axios封装采用“分层解耦”设计：request层负责axios实例配置与拦截器，api层按业务域拆分接口函数并标注TS类型，service层可选增强逻辑；接口路径统一由环境变量控制，api文件通过聚合导出提升导入体验。
Vue 3 中 Axios 封装的模块化 API 组织，核心是“分层解耦”：把请求逻辑（怎么发）和业务接口（发什么）彻底分开。不推荐把所有接口写在一个文件里，也不建议在组件中直接调用 axios —— 这样既难维护，也破坏了关注点分离。
1. 分三层结构：request → api → service
这是目前主流且可长期演进的组织方式：
-
request.ts（或 request.js）：仅负责创建 axios 实例、配置 baseURL、超时、拦截器（加 token、错误统一处理、取消重复请求等）。它不关心任何业务路径，只管“怎么发”。导出的是封装好的
service实例。 -
api/ 目录下按业务域拆分文件，例如：
userApi.ts、menuApi.ts、orderApi.ts。每个文件只定义本模块的请求函数，如getUserInfo()、updateUser(data)，内部调用service.get()或service.post()。 - service/（可选）：更进一步，可将 api 层再包装一层，加入缓存控制、权限校验前置、loading 状态联动等业务增强逻辑。适合中大型项目，小项目可省略，直接在 api 文件里返回 Promise。
2. api 文件写法示例（以 userApi.ts 为例）
每个函数语义清晰、参数明确、返回类型可推断：
import { service } from '@/utils/request'
import type { UserResponse, LoginParams } from '@/types/user'
<p>// 登录（无需 token）
export const login = (data: LoginParams) =>
service.post<UserResponse>('/base/access_token', data, { noNeedToken: true })</p><p>// 获取当前用户信息（需 token）
export const getUserInfo = () =>
service.get<UserResponse>('/base/userinfo')</p><p>// 获取用户菜单
export const getUserMenu = () =>
service.get<string[]>('/base/usermenu')
注意两点：一是使用 TypeScript 泛型标注响应数据类型；二是通过配置项（如 { noNeedToken: true }）控制拦截器行为，比硬编码判断更灵活。
立即学习“前端免费学习笔记（深入）”；
Vue 3 组合式 API 与
相关专题
Python属于前端也属于后端，其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容，供大家免费下载体验。
2503
2023.08.11
实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍：1、WebSocket，它可以在客户端和服务器之间建立持久连接，实现实时的双向通信，前端可以使用 WebSocket API来创建WebSocket连接，并通过发送和接收消息来实现即时通讯；2、Long Polling，是一种模拟实时通信的技术等等。
5423
2023.10.09
前端外包工作内容包括：1. 网站和应用程序开发；2. 用户界面和交互设计；3. 用户体验优化；4. 设计和视觉开发；5. 跨浏览器兼容性；6. 性能优化；7. 维护和更新；8. 项目管理和沟通。想了解更多前端的相关内容，可以阅读本专题下面的文章。
863
2024.05.22
vue2.0和3.0区别：vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现，vue3中使⽤了es6的proxy API对数据代理，实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容，供大家免费下载体验。
1674
2023.07.17
vue3的生命周期：1、beforecreate；2、created；3、beforemount；4、mounted；5、beforeupdate；6、updated；7、beforedestroy；8、destroyed；9、activated；10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容，供大家免费下载体验。
12102
2024.02.23
本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧，深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例，指导前端开发者实现高性能、结构清晰的 Vue 应用，提升开发效率与代码可维护性。
316
2026.02.10
Java应用运行缓慢，如何调整JVM参数？本专题介绍OpenJDK JVM性能调优的基本流程，涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析，帮助你先定位瓶颈，再通过对照测试验证效果，避免直接套用参数而影响应用稳定性。
20
2026.10.16
热门下载
相关下载
精品课程
最新文章
