❌ 别再用接口文档开发了!我改用“Mock-First”后爽到飞起

❌ 别再用接口文档开发了!我改用"Mock-First"后爽到飞起

"需求还没定、接口还在画、我代码已经跑起来了。"

以前做项目的时候,我们习惯等产品开完会、接口文档出完,再开始对接开发。结果呢?

  • 前端等后端接口

  • 后端接口改动,前端全重写

  • QA 说「这个字段对不上」

我现在统一团队流程:用 Mock 驱动开发,一口气解决这些问题。****


🚀 什么是 Mock-First 开发?

简单说,就是:

前端和后端约定 API 返回结构,然后前端直接根据 Mock 数据启动开发。

等接口 Ready,只需把 mock 切换成真实请求 ✅


⚒ 我怎么落地 Mock-First 的?

项目统一 mock 文件结构:

bash 复制代码
/mock
  ├── expense.ts        // /api/expense
  ├── auth.ts           // /api/login
  └── ...

mock 文件结构统一使用 vite-plugin-mock,支持本地启动自动注入 API:

javascript 复制代码
export default [
  {
    url: '/api/expense',
    method: 'get',
    response: () => ({
      total: 999,
      list: [...Array(10)].map((_, i) => ({ id: i, amount: 100 })),
    }),
  },
]

启动项目即拥有完整接口体验:

shell 复制代码
pnpm dev
# 所有 /api 路由 mock 自动生效

🧩 Mock-First 带来的好处?

✅ 不等接口,立刻开发

UI 写完,逻辑能调,完全模拟真实接口体验。

✅ 前后端提前约定数据结构

不再用脑子记字段,mock 文件就是文档。

✅ 更好测试逻辑分支

mock 可以按参数、状态模拟各种返回,不再等接口「上线测试环境」。

✅ 上线更稳,接口替换零改动

只需切换请求库 baseURL,mock 数据无感下线。


📦 项目实践场景(我的真实例子)

我目前的 CLI 工具、桌面 App、Flutter 项目,前期全部用 mock 开发逻辑:

  • gix:CLI 项目 mock 命令输出做测试
  • ixiu:Electron 本地提醒模拟时间任务
  • Flutter App:mock 数据驱动 UI 状态图、数据页分析图表

🧠 总结一句:

你不是不努力,是流程让你内耗。

Mock-First,不是偷懒,是一种「不依赖、快上线」的开发哲学。

写代码最怕"等"。不如自己把接口"造"出来。

相关推荐
程序员大阳7 分钟前
副队长ES6+教程(10)--迭代器 Iterator 与 for...of
javascript·es6·遍历·for of
夕水14 分钟前
受不了满屏广告的诗词网站,以及很多打不开的诗词网站,我干脆自己租服务器用trae重构了一个(纯公益、无广告)
前端·javascript
苏三说技术15 分钟前
为什么越来越多人用 OnlyOffice ?
后端
程序员大阳15 分钟前
副队长ES6+教程(15)--async和await
javascript·es6·async·promise·同步·异步·await
回家路上绕了弯15 分钟前
RAG:把知识库接进大模型,然后呢?
后端
SimonKing25 分钟前
快讯!local-notes素笺笔记又又又更新了!
java·后端·程序员
Rain的Java大神之路31 分钟前
面试官:设计一个自动售货机系统。我:别急着写代码,先问5个问题|状态机+防超卖+断电自愈,一套答法讲透
java·后端·面试
Brookty37 分钟前
HTML基础知识:表格布局、表单数据提交、元素标识与资源相对路径
前端·html
徐小夕1 小时前
开源!我们用知识图谱重构了电子档案,AI 驱动全文智能关联
前端·vue.js·github
不一样的少年_1 小时前
用了这 Skill,前端兄弟都觉得好
前端·后端·ai编程