Skip to content

Mock 数据

后端接口未就绪时,通过 Mock 在本地模拟接口返回。开关在 .env.development,Mock 文件在 mock/ 目录。

开启 Mock

.env.development 中设置:

bash
VITE_MOCK_DEV_SERVER = true

创建 Mock 文件

mock/ 目录下新建 xxx.mock.ts

typescript
// mock/user.mock.ts
import { defineMock } from "vite-plugin-mock-dev-server";

export default defineMock([
  {
    url: "/api/v1/users",
    method: "GET",
    response: (req) => {
      const { pageNum = 1, pageSize = 10 } = req.query;
      return {
        code: "00000",
        data: { list: [], total: 0 },
        msg: "成功",
      };
    },
  },
  {
    url: "/api/v1/users",
    method: "POST",
    response: (req) => {
      return {
        code: "00000",
        data: { id: Date.now(), ...req.body },
        msg: "添加成功",
      };
    },
  },
]);
  • url 匹配请求路径,支持 :id 动态段,通过 req.params 读取
  • response 返回的 code / data / msg 结构与后端响应保持一致
  • req.query 读取查询参数,req.body 读取请求体

响应延迟

delay 模拟网络耗时(毫秒):

typescript
{
  url: "/api/v1/users",
  method: "GET",
  delay: 1000,
  response: () => ({ code: "00000", data: [], msg: "成功" }),
}

切换真实接口

bash
# 关闭 Mock,走真实接口
VITE_MOCK_DEV_SERVER = false

基于 MIT 许可发布 · 如需部署协助或二开定制,请查看 支持与合作