在前后端分离开发过程中,最令人困扰的难题莫过于:后端接口尚未交付,前端却已卡在联调环节动弹不得。如果能随手生成一份结构清晰、字段合理且立即可用的 Mock 数据,那该有多方便?通义灵码恰好填补了这一缺口——它能够根据自然语言描述、Express 或 Vite 配置乃至 OpenAPI 文档,快速输出结构化的 Mock 接口数据。无论是直接生成 JSON 响应、Node.js Mock 服务代码、Vite 插件式 Mock 配置,还是自动解析 Swagger 文档批量生成规范数据,通义灵码都能轻松胜任。

简而言之,你只需告诉它想要的接口形态,剩下的 JSON 模板、路由配置以及数据填充工作,通义灵码都会替你完成。无需再手动编写繁琐的 JSON 模板,也不用逐条配置路由规则。
使用通义灵码指令生成 Mock 响应 JSON
打开通义灵码插件或 Web 界面,在对话框中输入清晰的接口语义描述。例如,可以这样输入:
“生成一个 GET /api/orders 接口的 Mock 响应,返回包含 id、orderNo、status(枚举值:pending/shipped/cancelled)、createdAt(ISO8601 格式时间字符串)、items 数组(每项含 name、price、quantity)的 JSON,共生成 5 条模拟订单数据”。
点击执行后,通义灵码会输出一份格式合法、字段语义准确且数量可控的 JSON 文本。你可直接将其复制到前端的请求拦截逻辑或 Mock 服务配置中,既省时又省力。
需要留意的是:如果指令中未明确指定字段类型或枚举范围,生成结果可能会有所偏差。因此,【务必在指令中将 status 可选值、时间格式、数组长度等约束写清楚】,否则 AI 会自行推断,最终结果可能不符合预期。
让通义灵码生成可运行的 Mock 服务代码
方式一:生成 Express 风格的 Node.js Mock 服务
输入如下指令:
“用 Express 编写一个本地 Mock 服务,监听 3001 端口,实现 GET /api/users 返回 10 个用户对象,每个对象包含 id、name、email、avatar(随机头像 URL)、createdAt(最近 7 天内的随机时间);同时支持 GET /api/users/:id 根据路径参数返回单个用户”。
通义灵码会输出一个完整可执行的 server.js 文件,其中包含 require、app 初始化、路由定义、Mock 数据生成逻辑以及 listen 调用。复制后即可直接运行。
方式二:生成 Vite 插件式 Mock(适用于 Vue / React 项目)
若你希望在现有 Vite 项目中快速集成 Mock,可以这样提问:
“为 Vite 项目生成 vite.config.ts 中的 mock 插件配置,拦截所有以 /api/ 开头的 GET 请求,对 /api/products 返回带分页的模拟商品列表(page=1, size=20, total=156),对 /api/products/:id 返回单个商品详情,使用 mockjs 生成数据”。
生成的代码可直接粘贴到 vite.config.ts 的 plugins 数组中。值得注意的是,通义灵码已自动为你引入 mockjs 并封装好响应逻辑,你无需额外安装任何插件。
基于已有 API 文档批量生成 Mock
如果你的团队已经拥有 Swagger / OpenAPI 3.0 格式的 YAML 或 JSON 文档(例如 openapi.json),那么批量生成 Mock 将更加便捷。
第一步:确认你手头持有这份文档。
第二步:直接将文件拖拽到通义灵码工作区(支持拖拽或文件选择)。
第三步:在指令栏输入:
“根据已上传的 OpenAPI 文档,为所有 GET 路径生成 Mock 响应 JSON 示例,要求:① 使用 response schema 中的 example 字段作为主要数据源;② 若无 example,则按照 type 和 format 推导合理的默认值;③ 为路径参数 {id} 和查询参数 page / size 注入占位逻辑”。
第四步:检查生成结果。确保每个 operationId 都对应独立的响应块,同时确认路径参数解析方式是否匹配你的调用习惯——例如 /api/users/{id} 是否对应了 req.params.id。
整个操作流程非常简单,只需把文件拖进去即可。通义灵码会自动识别 paths、components、schemas 结构,完全无需手动标注或逐条翻译 API 文档。
