~/VibeHandbook
免费 PDF

08 · 06

提供示例

一个具体的示例抵得上一段描述。如果你想要某种特定形状的输出,就把那个形状给它看。这是消除歧义最快的方法。

把数据格式化得漂亮些。
把这个用户数组转换成一个汇总对象。

输入:
  [{ name: "Ann", role: "admin" }, { name: "Bo", role: "user" }]

期望输出:
  { total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }

写出转换函数,以及一个与该示例匹配的测试。

示例钉死了命名、结构和大小写——这些光靠文字会留得模糊不清。当你能做到时,把示例作为一个测试包含进去——这样"让这个测试通过"就成了一条没有歧义的指令。这个套路可以推广:一份样例 (应用程序编程接口 —— 一个程序向另一个程序请求数据的方式)响应钉死一个解析器,一对"改前/改后"钉死一次重构,一张截图或 ASCII 草图钉死一个布局。每当你发现自己正在写一长段对某个形状的描述时,停下来,改为给它看那个形状的一个实例。

想离线阅读?

免费下载整本书的 PDF 或 EPUB。