Vue 3集成Mock.js的核心是装对包、拦截请求、统一管理,开发环境生效而生产环境自动关闭;Vite需安装mockjs和vite-plugin-mock并配置插件,Vue CLI只需mockjs并在main中条件引入;所有mock规则集中维护,用Mock.js语法生成动态数据,axios请求零修改即可被拦截返回模拟响应。

Vue 3 项目初始化后集成 Mock.js,核心是「装对包 + 拦截请求 + 统一管理」,不改业务代码就能让 axios 请求直接返回模拟数据。关键在于开发环境生效、生产环境自动关闭,避免误用。
安装依赖(区分运行时与开发时)
Mock.js 本身不发请求,只生成数据;它需要配合请求库(如 axios)或构建工具插件来拦截真实调用:
- 若用 Vite(推荐主流方案):安装
mockjs和vite-plugin-mock(开发依赖)npm install mockjs -D && npm install vite-plugin-mock@2.9.6 -D - 若用 Vue CLI:只需
mockjs(运行时依赖)npm install mockjs --save - 确保已安装
axios(用于实际请求,Mock 不替代它)npm install axios
配置 Mock 入口(按技术栈选一种)
目标是让所有 mock 规则集中注册、便于维护,且仅在开发阶段启用:
使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。
-
Vite 项目:在
vite.config.ts的plugins中加入:viteMockServe({ mockPath: 'mock', localEnabled: true })
然后在项目根目录建mock/文件夹,里面放user.ts、article.ts等模块文件,导出符合MockMethod类型的对象数组 -
Vue CLI 项目:在
src/mock/index.js中统一引入并注册:import Mock from 'mockjs'; Mock.setup({ timeout: '300-800' });
再用require.context自动加载src/mock/modules/下所有 .js 文件,循环调用Mock.mock()
编写可复用的模拟接口规则
别写死数据,用 Mock.js 语法生成动态结构,贴近真实接口形态:
立即学习“前端免费学习笔记(深入)”;
- 路径匹配支持正则,例如:
Mock.mock(/\/api\/users\/\d+/, 'get', { id: '@id', name: '@cname' }) - 常用动态能力:
'list|5-10'→ 随机生成 5 到 10 条数据'id|+1'→ 自增 ID'email': '@email'→ 随机邮箱'createdAt': '@datetime("yyyy-MM-dd HH:mm")'→ 格式化时间 - 登录接口示例(返回 token + 用户信息):
{ code: 200, data: { token: 'mock-token-xxx', user: { username: 'admin', roles: ['admin'] } } }
对接业务代码(零侵入)
你写的 axios 请求完全不用改,只要 URL 和 method 匹配 mock 规则,就会被拦截返回模拟数据:
- API 层保持原样,例如:
axios.post('/api/login', { u: 'a', p: '123' }) - 确保
main.js或main.ts中引入了 mock 入口:if (process.env.NODE_ENV === 'development') { require('./mock') }(Vue CLI)
Vite 项目无需手动引入,插件自动处理 - 浏览器控制台 Network 面板能看到该请求状态码为 200,但 Type 显示
xhr (mock),说明已被拦截

















