# 先写不做什么

**URL:** <https://buildx.do/t/%E5%85%88%E5%86%99%E4%B8%8D%E5%81%9A%E4%BB%80%E4%B9%88/201>\
**Category:** 方案论道\
**Tags:** 架构研讨\
**Created:** [2026 年10 月 7 日 05:29 UTC](https://buildx.do/t/%E5%85%88%E5%86%99%E4%B8%8D%E5%81%9A%E4%BB%80%E4%B9%88/201 "2026-10-07T05:29:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![shenrui](https://buildx.do/letter_avatar_proxy/v4/letter/s/22d042/32.png) [@shenrui](https://buildx.do/u/shenrui)\
**Post date:** [2026 年10 月 7 日 05:29 UTC](https://buildx.do/t/%E5%85%88%E5%86%99%E4%B8%8D%E5%81%9A%E4%BB%80%E4%B9%88/201/1 "2026-10-07T05:29:00Z")

</div>

「先写不做什么」。

范围才不会越谈越大。我们把不做的三条写在文档最上面。

判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。

先写不做什么。多一个组件就多一种故障，量不大就不要先加队列或缓存。每一层的等待时间写明，重试要有次数和间隔的上限。同一状态只在一个地方改。请求编号从入口带下去，不然日志对不起来。决定用一段话记下来。

先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。

复查「先写不做什么」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。讨论先写三行不做什么，避免范围越加越大。量不大就不要先加队列或缓存，多一个组件就多一种故障。每一层等待时间写明，用户看到的失败常常只是最外层超时。重试要有次数和间隔的上限，否则失败会把下游打满。同一状态只允许一个地方改。请求编号从入口生成并往后传，没有编号就不要谈跨服务排查。决定用一段话记在仓库里。两个月后没这段话，会原样再吵一次。

操作顺序。1. 开头写三件不做什么。2. 标出每一层谁调用谁，以及等待多久。3. 重试写上次数和间隔的上限。4. 同一状态指定唯一可以改它的地方。5. 量不大就先不要加队列或缓存，把直接路径做稳。6. 请求编号从入口生成并往后传。7. 决定用一段话写进仓库：为什么这样，什么时候再看。没有这段话，两个月后会用同样的论据再吵一次。图只保留调用关系，例外用文字说明。

---

<div class="post-metadata">

**Author:** ![suyanran](https://buildx.do/letter_avatar_proxy/v4/letter/s/b2d939/32.png) [@suyanran](https://buildx.do/u/suyanran)\
**Post date:** [2026 年10 月 7 日 06:10 UTC](https://buildx.do/t/%E5%85%88%E5%86%99%E4%B8%8D%E5%81%9A%E4%BB%80%E4%B9%88/201/2 "2026-10-07T06:10:00Z")

</div>

不做什么写在最上面。否则讨论会把范围越加越大。
