# \#工程实践

**URL:** https://buildx.do/tag/engineering/18.md

[最新](https://buildx.do/latest.md) · [类别](https://buildx.do/categories.md) · [标签](https://buildx.do/tags.md)

---

## [回滚脚本今天真的用了一次](https://buildx.do/t/%E5%9B%9E%E6%BB%9A%E8%84%9A%E6%9C%AC%E4%BB%8A%E5%A4%A9%E7%9C%9F%E7%9A%84%E7%94%A8%E4%BA%86%E4%B8%80%E6%AC%A1/263)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 0\
**最近更新：:** [2026 年10 月 8 日 05:08 UTC](https://buildx.do/t/%E5%9B%9E%E6%BB%9A%E8%84%9A%E6%9C%AC%E4%BB%8A%E5%A4%A9%E7%9C%9F%E7%9A%84%E7%94%A8%E4%BA%86%E4%B8%80%E6%AC%A1/263 "2026-10-08T05:08:00Z")

</div>

不是演练。发布后错误率上去，按脚本撤回到上一份产物，四分钟。脚本里有一行会停下来等确认，当时觉得烦，今天就是靠它没撤错环境。

---

## [债列出来](https://buildx.do/t/%E5%80%BA%E5%88%97%E5%87%BA%E6%9D%A5/238)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 01:54 UTC](https://buildx.do/t/%E5%80%BA%E5%88%97%E5%87%BA%E6%9D%A5/238 "2026-10-08T01:54:00Z")

</div>

「债列出来」。 放在心里会忘，也会变成脾气。列表上的可以排期。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下来，不放在心…

---

## [提交说明写为什么](https://buildx.do/t/%E6%8F%90%E4%BA%A4%E8%AF%B4%E6%98%8E%E5%86%99%E4%B8%BA%E4%BB%80%E4%B9%88/228)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 20:34 UTC](https://buildx.do/t/%E6%8F%90%E4%BA%A4%E8%AF%B4%E6%98%8E%E5%86%99%E4%B8%BA%E4%BB%80%E4%B9%88/228 "2026-10-07T20:34:00Z")

</div>

「提交说明写为什么」。 改了什么，差异里看得到。为什么改，只有说明里有。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不…

---

## [告警少一点](https://buildx.do/t/%E5%91%8A%E8%AD%A6%E5%B0%91%E4%B8%80%E7%82%B9/235)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 00:18 UTC](https://buildx.do/t/%E5%91%8A%E8%AD%A6%E5%B0%91%E4%B8%80%E7%82%B9/235 "2026-10-08T00:18:00Z")

</div>

「告警少一点」。 太多就没人看。留下真正要人起来的那几条。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。…

---

## [评审先看行为](https://buildx.do/t/%E8%AF%84%E5%AE%A1%E5%85%88%E7%9C%8B%E8%A1%8C%E4%B8%BA/227)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 20:02 UTC](https://buildx.do/t/%E8%AF%84%E5%AE%A1%E5%85%88%E7%9C%8B%E8%A1%8C%E4%B8%BA/227 "2026-10-07T20:02:00Z")

</div>

「评审先看行为」。 格式可以后面改。行为错了，格式对也没有用。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下来，不放在心…

---

## [说明和代码放一起](https://buildx.do/t/%E8%AF%B4%E6%98%8E%E5%92%8C%E4%BB%A3%E7%A0%81%E6%94%BE%E4%B8%80%E8%B5%B7/233)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 23:14 UTC](https://buildx.do/t/%E8%AF%B4%E6%98%8E%E5%92%8C%E4%BB%A3%E7%A0%81%E6%94%BE%E4%B8%80%E8%B5%B7/233 "2026-10-07T23:14:00Z")

</div>

「说明和代码放一起」。 另开的文档会忘。仓库里的文件会跟着改。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下来，不放在心…

---

## [事故后写如何更早发现](https://buildx.do/t/%E4%BA%8B%E6%95%85%E5%90%8E%E5%86%99%E5%A6%82%E4%BD%95%E6%9B%B4%E6%97%A9%E5%8F%91%E7%8E%B0/231)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 22:10 UTC](https://buildx.do/t/%E4%BA%8B%E6%95%85%E5%90%8E%E5%86%99%E5%A6%82%E4%BD%95%E6%9B%B4%E6%97%A9%E5%8F%91%E7%8E%B0/231 "2026-10-07T22:10:00Z")

</div>

「事故后写如何更早发现」。 不是写谁的错。写一个信号，下次更早响。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和…

---

## [时间写成范围](https://buildx.do/t/%E6%97%B6%E9%97%B4%E5%86%99%E6%88%90%E8%8C%83%E5%9B%B4/232)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 22:42 UTC](https://buildx.do/t/%E6%97%B6%E9%97%B4%E5%86%99%E6%88%90%E8%8C%83%E5%9B%B4/232 "2026-10-07T22:42:00Z")

</div>

「时间写成范围」。 三到五天，比‘周五一定好’诚实。范围迫使把不确定说出来。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写…

---

## [开关比长期分支省事](https://buildx.do/t/%E5%BC%80%E5%85%B3%E6%AF%94%E9%95%BF%E6%9C%9F%E5%88%86%E6%94%AF%E7%9C%81%E4%BA%8B/230)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 21:38 UTC](https://buildx.do/t/%E5%BC%80%E5%85%B3%E6%AF%94%E9%95%BF%E6%9C%9F%E5%88%86%E6%94%AF%E7%9C%81%E4%BA%8B/230 "2026-10-07T21:38:00Z")

</div>

「开关比长期分支省事」。 分支放太久，合回来很痛。开关可以关着上线。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债…

---

## [开发时可以先做的五件无障碍小事](https://buildx.do/t/%E5%BC%80%E5%8F%91%E6%97%B6%E5%8F%AF%E4%BB%A5%E5%85%88%E5%81%9A%E7%9A%84%E4%BA%94%E4%BB%B6%E6%97%A0%E9%9A%9C%E7%A2%8D%E5%B0%8F%E4%BA%8B/251)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 4\
**最近更新：:** [2026 年10 月 8 日 16:20 UTC](https://buildx.do/t/%E5%BC%80%E5%8F%91%E6%97%B6%E5%8F%AF%E4%BB%A5%E5%85%88%E5%81%9A%E7%9A%84%E4%BA%94%E4%BB%B6%E6%97%A0%E9%9A%9C%E7%A2%8D%E5%B0%8F%E4%BA%8B/251 "2026-10-08T16:20:00Z")

</div>

无障碍不是等设计全部做完再补的一层皮肤。页面只要有人用读屏、只用键盘，或者看不清细字，问题在第一天就会出现。GB/T 37668 把可访问性分成能感知、能操作、能理解、能兼容辅助技术。落到我们自己的项目，可以先做五件成本很低的事。 第一，每张有信息的图片写替代文字。装饰图用空替代，避免读屏把文件名念出来。第二，表单控件要有可见的文字标签，不要只靠占位符。占位符一输入就消失，读屏也不稳定。第三，键盘能到达所有按钮和链接，焦点要看得见。不要用只能鼠标点的 div 假装按钮。第四，文字和背景的对比不要只靠浅灰。看不清的人会直接离开。第五，不要在页面里禁止缩放，也不要靠颜色单独表达成功或失败。 这…

---

## [决定写下来](https://buildx.do/t/%E5%86%B3%E5%AE%9A%E5%86%99%E4%B8%8B%E6%9D%A5/237)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [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 "2026-10-08T01:22:00Z")

</div>

「决定写下来」。 两个月后会再吵一次。一段话就能省掉。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债写下…

---

## [值班的人要能自己回滚](https://buildx.do/t/%E5%80%BC%E7%8F%AD%E7%9A%84%E4%BA%BA%E8%A6%81%E8%83%BD%E8%87%AA%E5%B7%B1%E5%9B%9E%E6%BB%9A/234)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 23:46 UTC](https://buildx.do/t/%E5%80%BC%E7%8F%AD%E7%9A%84%E4%BA%BA%E8%A6%81%E8%83%BD%E8%87%AA%E5%B7%B1%E5%9B%9E%E6%BB%9A/234 "2026-10-07T23:46:00Z")

</div>

「值班的人要能自己回滚」。 不能回滚的发布，就不要在一个人值班时上。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安…

---

## [主干要能发布](https://buildx.do/t/%E4%B8%BB%E5%B9%B2%E8%A6%81%E8%83%BD%E5%8F%91%E5%B8%83/229)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 21:06 UTC](https://buildx.do/t/%E4%B8%BB%E5%B9%B2%E8%A6%81%E8%83%BD%E5%8F%91%E5%B8%83/229 "2026-10-07T21:06:00Z")

</div>

「主干要能发布」。 坏了就别留在主干上等周末。当天修或当天撤。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理…

---

## [第一周不排大功能](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E5%91%A8%E4%B8%8D%E6%8E%92%E5%A4%A7%E5%8A%9F%E8%83%BD/236)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 00:50 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E5%91%A8%E4%B8%8D%E6%8E%92%E5%A4%A7%E5%8A%9F%E8%83%BD/236 "2026-10-08T00:50:00Z")

</div>

「第一周不排大功能」。 先让新人能跑、能问、能提交。大功能下周再说。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 评审先看行为对不对，格式可以后改。提交说明写为什么，差异里已经看得到改了什么。主干当天要能发布，不能回滚的变更不要安排在只有一个人值班的时候。告警只留需要人处理的。决定和欠下的债…
