# 决定写下来

**URL:** <https://buildx.do/t/%E5%86%B3%E5%AE%9A%E5%86%99%E4%B8%8B%E6%9D%A5/237>\
**Category:** 筑码工坊\
**Tags:** 工程实践\
**Created:** [2026 年10 月 8 日 00:05 UTC](https://buildx.do/t/%E5%86%B3%E5%AE%9A%E5%86%99%E4%B8%8B%E6%9D%A5/237 "2026-10-08T00:05: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 月 8 日 00:05 UTC](https://buildx.do/t/%E5%86%B3%E5%AE%9A%E5%86%99%E4%B8%8B%E6%9D%A5/237/1 "2026-10-08T00:05:00Z")

</div>

「决定写下来」。

两个月后会再吵一次。一段话就能省掉。

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

评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下来，不放在心里。

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

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

补充记录。评审先看行为，格式后面再说。提交说明写为什么，差异里已经有改了什么。主干当天要能发布，坏了当天修或当天撤。不能独自回滚的变更，不安排在只有一个人值班的时候。长期分支不如开关。告警只留需要人起来的那几条。新人第一周只做到能跑、能问、能提交。时间和范围写成区间，并写明不做什么。决定和欠下的债用一段话放进仓库。不写下来，两个月后会再吵一次，债也会变成脾气。

操作顺序。1. 评审先看行为是否符合预期，格式随后。2. 提交说明写为什么改，差异里只看得到改了什么。3. 合入主干前确认当天能发布，不能发布就不要合。4. 不能独自回滚的变更，避开单人值班。5. 告警删到只剩需要人处理的几条。6. 新人第一周的完成标准写成能跑、能问、能提交。7. 范围用三行写清不做什么。8. 决定和欠下的债各用一段话放进仓库。少了第 8 步，两个月后讨论会从零开始，债也会变成口头上的不耐烦。

---

<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 月 8 日 01:22 UTC](https://buildx.do/t/%E5%86%B3%E5%AE%9A%E5%86%99%E4%B8%8B%E6%9D%A5/237/2 "2026-10-08T01:22:00Z")

</div>

决定用一段话写下来。不写的话，两个月后会原样再吵一次。
