API文档还能生成Mock数据？很多人还没用上
前端写页面时，后端接口经常没准备好。等一天，改一行代码；再等一天，又卡住。这种情况太常见了。以前只能靠手动模拟一些假数据，或者让后端临时返回点测试内容，效率低还容易出错。
其实现在很多项目里，只要有一份清晰的 API 文档，比如 Swagger（OpenAPI）格式的，就能自动“变”出一整套模拟数据，也就是 Mock 数据。不需要真实接口，也能跑起来调试。
什么是 Mock 数据
M涉就是“假装”。Mock 数据就是长得像真数据、用起来像真数据，但其实是假的数据。比如用户列表接口还没做完，你可以先让它返回 10 条带名字、头像、手机号的虚拟用户，前端照样能做分页、搜索、点击跳转。
怎么从 API 文档生成 Mock
假设你拿到一个 OpenAPI 3.0 的 YAML 文件，里面定义了 /api/users 接口，返回的是用户数组，每个用户有 id、name、email 字段。这时候可以用工具自动解析这个文档，根据字段类型和示例生成对应的假数据。
常见的做法是结合 Swagger UI 或 Stoplight Studio 这类工具，在线预览文档的同时开启 Mock 功能。也可以用 Node.js 工具如 openapi-mock，启动一个本地服务：
npx openapi-mock api.yaml --port 4010访问 http://localhost:4010/api/users，就能看到自动生成的模拟响应，连状态码和分页结构都对得上。
自己加点“料”，让数据更真实
默认生成的数据可能太规整，比如所有名字都是 "string"。可以在文档里加点例子或注释，告诉工具该怎么造数据：
email:
type: string
format: email
example: user@example.com
name:
type: string
example: 张小明这样生成的每条数据就更贴近实际，测试表单校验、渲染逻辑也更有意义。
有些团队还会把这套流程集成进 CI 环节，只要文档一更新，Mock 服务自动刷新，前后端沟通成本直接降下来。
不只是前端，后端也能用
别以为只有前端需要 Mock。后端联调第三方服务时，比如支付网关、短信平台，也可以用 API 文档生成 Mock 响应，避免频繁调用真实接口被限流，或者产生费用。
比如你在开发订单系统，依赖一个还没上线的物流查询接口。只要拿到对方提供的 OpenAPI 定义，立刻就能本地起一个模拟服务，返回“运输中”“已签收”等各种状态，用来测试不同场景下的业务逻辑。
现在不少公司都开始推“契约先行”的开发模式：先把 API 文档定好，然后前后端各干各的，靠 Mock 数据并行推进。等真接口一通，往往只需要微调，不用从头对接。
下次看到 API 文档，别只当它是说明文件。它其实是一把钥匙，能打开自动化 Mock 的门，让开发节奏快上不止一点。