# Latest

**URL:** https://buildx.do/latest.md?page=7

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

**Page:** 8

---

## [输出写成人话](https://buildx.do/t/%E8%BE%93%E5%87%BA%E5%86%99%E6%88%90%E4%BA%BA%E8%AF%9D/218)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 15:14 UTC](https://buildx.do/t/%E8%BE%93%E5%87%BA%E5%86%99%E6%88%90%E4%BA%BA%E8%AF%9D/218 "2026-10-07T15:14:00Z")

</div>

「输出写成人话」。 不要只吐一串代号。写下一步可以做什么。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 脚本要敢再跑一次：空参数直接退出，做完的步骤跳过，失败用非零退出码。真正修改之前先打印将要做什么。密码和家目录路径不要写死。日志追加到固定文件，定时跑失败才有人能看见。文件开头写清参数和一…

---

## [第一次提交前看什么](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4%E5%89%8D%E7%9C%8B%E4%BB%80%E4%B9%88/96)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 00:40 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4%E5%89%8D%E7%9C%8B%E4%BB%80%E4%B9%88/96 "2026-10-05T00:40:00Z")

</div>

「第一次提交前看什么」。 差异、不该提交的文件、能不能在干净目录跑起来。三件事做完再推。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出…

---

## [序列图画得轻一点](https://buildx.do/t/%E5%BA%8F%E5%88%97%E5%9B%BE%E7%94%BB%E5%BE%97%E8%BD%BB%E4%B8%80%E7%82%B9/110)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 07:18 UTC](https://buildx.do/t/%E5%BA%8F%E5%88%97%E5%9B%BE%E7%94%BB%E5%BE%97%E8%BD%BB%E4%B8%80%E7%82%B9/110 "2026-10-05T07:18:00Z")

</div>

「序列图画得轻一点」。 方块和箭头就够讨论。画完把原文件放进仓库，别只留导出的图。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认…

---

## [重试要有上限](https://buildx.do/t/%E9%87%8D%E8%AF%95%E8%A6%81%E6%9C%89%E4%B8%8A%E9%99%90/195)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 03:48 UTC](https://buildx.do/t/%E9%87%8D%E8%AF%95%E8%A6%81%E6%9C%89%E4%B8%8A%E9%99%90/195 "2026-10-07T03:48:00Z")

</div>

「重试要有上限」。 失败会放大。没有上限的重试曾经把下游打满。次数和间隔都要写。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先写不做什么。多一个组件就多一种故障，量不大就不要先加队列或缓存。每一层的等待时间写明，重试要有次数和间隔的上限。同一状态只在一个地方改。请求编号从入口带下…

---

## [下个月交换手里的小工具](https://buildx.do/t/%E4%B8%8B%E4%B8%AA%E6%9C%88%E4%BA%A4%E6%8D%A2%E6%89%8B%E9%87%8C%E7%9A%84%E5%B0%8F%E5%B7%A5%E5%85%B7/178)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 18:44 UTC](https://buildx.do/t/%E4%B8%8B%E4%B8%AA%E6%9C%88%E4%BA%A4%E6%8D%A2%E6%89%8B%E9%87%8C%E7%9A%84%E5%B0%8F%E5%B7%A5%E5%85%B7/178 "2026-10-06T18:44:00Z")

</div>

「下个月交换手里的小工具」。 每人介绍一个自己真的在用的。不限品类。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 活动只为一件具体的事，时间写短。读代码就读一个真实函数，分享就讲一个问题。自我介绍两句就够：在写什么，卡在哪。结束后留下能查的记录，不只有当时的口头。不对的地方直接说，只点赞的话错误会留在…

---

## [示例和当前版本对不上](https://buildx.do/t/%E7%A4%BA%E4%BE%8B%E5%92%8C%E5%BD%93%E5%89%8D%E7%89%88%E6%9C%AC%E5%AF%B9%E4%B8%8D%E4%B8%8A/77)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 14:32 UTC](https://buildx.do/t/%E7%A4%BA%E4%BE%8B%E5%92%8C%E5%BD%93%E5%89%8D%E7%89%88%E6%9C%AC%E5%AF%B9%E4%B8%8D%E4%B8%8A/77 "2026-10-04T14:32:00Z")

</div>

「示例和当前版本对不上」。 示例还是上一个大版本。照着做会报参数不存在。看发布记录再抄。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。给上游提修改…

---

## [一张图对齐得更快](https://buildx.do/t/%E4%B8%80%E5%BC%A0%E5%9B%BE%E5%AF%B9%E9%BD%90%E5%BE%97%E6%9B%B4%E5%BF%AB/202)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 06:42 UTC](https://buildx.do/t/%E4%B8%80%E5%BC%A0%E5%9B%BE%E5%AF%B9%E9%BD%90%E5%BE%97%E6%9B%B4%E5%BF%AB/202 "2026-10-07T06:42:00Z")

</div>

「一张图对齐得更快」。 长文大家读不完。图上标出谁调用谁。文字只解释例外。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 先写不做什么。多一个组件就多一种故障，量不大就不要先加队列或缓存。每一层的等待时间写明，重试要有次数和间隔的上限。同一状态只在一个地方改。请求编号从入口带下去，不然日志对不起来。决定…

---

## [接口调试的环境分开存](https://buildx.do/t/%E6%8E%A5%E5%8F%A3%E8%B0%83%E8%AF%95%E7%9A%84%E7%8E%AF%E5%A2%83%E5%88%86%E5%BC%80%E5%AD%98/108)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 06:14 UTC](https://buildx.do/t/%E6%8E%A5%E5%8F%A3%E8%B0%83%E8%AF%95%E7%9A%84%E7%8E%AF%E5%A2%83%E5%88%86%E5%BC%80%E5%AD%98/108 "2026-10-05T06:14:00Z")

</div>

「接口调试的环境分开存」。 本地、测试各一份。切换时不会把测试地址拿去打生产。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地…

---

## [日志打到标准输出](https://buildx.do/t/%E6%97%A5%E5%BF%97%E6%89%93%E5%88%B0%E6%A0%87%E5%87%86%E8%BE%93%E5%87%BA/55)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 02:48 UTC](https://buildx.do/t/%E6%97%A5%E5%BF%97%E6%89%93%E5%88%B0%E6%A0%87%E5%87%86%E8%BE%93%E5%87%BA/55 "2026-10-04T02:48:00Z")

</div>

「日志打到标准输出」。 不再追某个文件还在不在。收集稳定之后，排错不用进到机器里面。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 先分清是没起来、起来了但检查失败，还是流量打到了正在退出的实例。就绪检查只打真正加载完的轻量路径，并给几秒宽限。配置和密钥分开，改完写明要…

---

## [循环里不要查](https://buildx.do/t/%E5%BE%AA%E7%8E%AF%E9%87%8C%E4%B8%8D%E8%A6%81%E6%9F%A5/205)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 08:18 UTC](https://buildx.do/t/%E5%BE%AA%E7%8E%AF%E9%87%8C%E4%B8%8D%E8%A6%81%E6%9F%A5/205 "2026-10-07T08:18:00Z")

</div>

「循环里不要查」。 几十次变成一次。改动小，效果明显。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命中率。索引让写入变慢如果可以接受，就写进备注，避免以后被人删…

---

## [一次别返回那么多](https://buildx.do/t/%E4%B8%80%E6%AC%A1%E5%88%AB%E8%BF%94%E5%9B%9E%E9%82%A3%E4%B9%88%E5%A4%9A/210)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 10:58 UTC](https://buildx.do/t/%E4%B8%80%E6%AC%A1%E5%88%AB%E8%BF%94%E5%9B%9E%E9%82%A3%E4%B9%88%E5%A4%9A/210 "2026-10-07T10:58:00Z")

</div>

「一次别返回那么多」。 页面只用十行，接口给了全部。减半之后快了，也清楚了。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命…

---

## [把本地环境跑起来的顺序](https://buildx.do/t/%E6%8A%8A%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E8%B7%91%E8%B5%B7%E6%9D%A5%E7%9A%84%E9%A1%BA%E5%BA%8F/95)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 00:08 UTC](https://buildx.do/t/%E6%8A%8A%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E8%B7%91%E8%B5%B7%E6%9D%A5%E7%9A%84%E9%A1%BA%E5%BA%8F/95 "2026-10-05T00:08:00Z")

</div>

「把本地环境跑起来的顺序」。 先运行时，再依赖，再配置，最后起服务。跳步通常会卡在一个看不懂的错。这篇按这个顺序写。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里…

---

## [不用 root 跑](https://buildx.do/t/%E4%B8%8D%E7%94%A8-root-%E8%B7%91/60)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 05:28 UTC](https://buildx.do/t/%E4%B8%8D%E7%94%A8-root-%E8%B7%91/60 "2026-10-04T05:28:00Z")

</div>

「不用 root 跑」。 权限报错补目录就好，别图省事改回 root。出问题的时候影响面小一些。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印…

---

## [测试绕开了真实路径](https://buildx.do/t/%E6%B5%8B%E8%AF%95%E7%BB%95%E5%BC%80%E4%BA%86%E7%9C%9F%E5%AE%9E%E8%B7%AF%E5%BE%84/39)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 19:06 UTC](https://buildx.do/t/%E6%B5%8B%E8%AF%95%E7%BB%95%E5%BC%80%E4%BA%86%E7%9C%9F%E5%AE%9E%E8%B7%AF%E5%BE%84/39 "2026-10-03T19:06:00Z")

</div>

测试全绿，手工走一遍就会失败。差别在测试直接 new 了对象，没走工厂，也没走线上那套默认值。 线上默认有一项超时和一项开关，测试对象里是空的。空值在测试里恰好能过，到了真实创建路径就缺字段。 补了一条从工厂创建、再走完整保存的测试。这条比原来那组慢一点，但能抓住默认值。 原来的纯对象测试还留着，用来看计算本身。两种测试的名字写明了各自不保证什么。 工厂里的默认值和生产配置放在一起对照过一次。不一样的地方，要么改工厂，要么在注释…

---

## [健康检查打到了要登录的地址](https://buildx.do/t/%E5%81%A5%E5%BA%B7%E6%A3%80%E6%9F%A5%E6%89%93%E5%88%B0%E4%BA%86%E8%A6%81%E7%99%BB%E5%BD%95%E7%9A%84%E5%9C%B0%E5%9D%80/50)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 00:08 UTC](https://buildx.do/t/%E5%81%A5%E5%BA%B7%E6%A3%80%E6%9F%A5%E6%89%93%E5%88%B0%E4%BA%86%E8%A6%81%E7%99%BB%E5%BD%95%E7%9A%84%E5%9C%B0%E5%9D%80/50 "2026-10-04T00:08:00Z")

</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/%E6%8A%8A%E8%B6%85%E6%97%B6%E5%8A%A0%E9%95%BF%E5%8F%AA%E6%98%AF%E8%97%8F%E9%97%AE%E9%A2%98/90)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 21:28 UTC](https://buildx.do/t/%E6%8A%8A%E8%B6%85%E6%97%B6%E5%8A%A0%E9%95%BF%E5%8F%AA%E6%98%AF%E8%97%8F%E9%97%AE%E9%A2%98/90 "2026-10-04T21:28:00Z")

</div>

「把超时加长只是藏问题」。 从五秒改到十五秒，失败少了，慢还在。先找为什么慢。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，…

---

## [启动时预热](https://buildx.do/t/%E5%90%AF%E5%8A%A8%E6%97%B6%E9%A2%84%E7%83%AD/211)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 11:30 UTC](https://buildx.do/t/%E5%90%AF%E5%8A%A8%E6%97%B6%E9%A2%84%E7%83%AD/211 "2026-10-07T11:30:00Z")

</div>

「启动时预热」。 第一批访问不再卡。预热的是真正会用到的那部分。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命中率。索引让写入变慢如果可以接受，就写进备注，避免…

---

## [越往后的页越慢](https://buildx.do/t/%E8%B6%8A%E5%BE%80%E5%90%8E%E7%9A%84%E9%A1%B5%E8%B6%8A%E6%85%A2/207)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 09:22 UTC](https://buildx.do/t/%E8%B6%8A%E5%BE%80%E5%90%8E%E7%9A%84%E9%A1%B5%E8%B6%8A%E6%85%A2/207 "2026-10-07T09:22:00Z")

</div>

「越往后的页越慢」。 改成按主键继续翻。深页不再扫描前面所有行。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命中率。索引让写入变慢如果可以接受，就写进备注，避免以后被人删掉。…

---

## [晚上补完的导入](https://buildx.do/t/%E6%99%9A%E4%B8%8A%E8%A1%A5%E5%AE%8C%E7%9A%84%E5%AF%BC%E5%85%A5/142)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 00:22 UTC](https://buildx.do/t/%E6%99%9A%E4%B8%8A%E8%A1%A5%E5%AE%8C%E7%9A%84%E5%AF%BC%E5%85%A5/142 "2026-10-06T00:22:00Z")

</div>

「晚上补完的导入」。 以前只能手工贴。现在能从文件读。边界情况还有，但主路径通了。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 展示的是一个能用的小东西，不是计划。写清楚它解决哪一件具体的事，输入是什么，输出是什么，什么情况下不要用。边界没做完就直说。主路径通了就可以给别人试，不必等所有边角都齐。 这…

---

## [先打印将要做什么](https://buildx.do/t/%E5%85%88%E6%89%93%E5%8D%B0%E5%B0%86%E8%A6%81%E5%81%9A%E4%BB%80%E4%B9%88/223)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 17:54 UTC](https://buildx.do/t/%E5%85%88%E6%89%93%E5%8D%B0%E5%B0%86%E8%A6%81%E5%81%9A%E4%BB%80%E4%B9%88/223 "2026-10-07T17:54:00Z")

</div>

「先打印将要做什么」。 确认再执行真正的修改。多这一步，少一次误删。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 脚本要敢再跑一次：空参数直接退出，做完的步骤跳过，失败用非零退出码。真正修改之前先打印将要做什么。密码和家目录路径不要写死。日志追加到固定文件，定时跑失败…

---

## [错误提示改成像说话](https://buildx.do/t/%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA%E6%94%B9%E6%88%90%E5%83%8F%E8%AF%B4%E8%AF%9D/140)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 23:18 UTC](https://buildx.do/t/%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA%E6%94%B9%E6%88%90%E5%83%8F%E8%AF%B4%E8%AF%9D/140 "2026-10-05T23:18:00Z")

</div>

「错误提示改成像说话」。 少写代码，多写人能看懂的下一件事。用了一周，询问少了。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 展示的是一个能用的小东西，不是计划。写清楚它解决哪一件具体的事，输入是什么，输出是什么，什么情况下不要用。边界没做完就直说。主路径通了就可以给别人试，不必等所有边角都…

---

## [看日志顺手的办法](https://buildx.do/t/%E7%9C%8B%E6%97%A5%E5%BF%97%E9%A1%BA%E6%89%8B%E7%9A%84%E5%8A%9E%E6%B3%95/107)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 05:42 UTC](https://buildx.do/t/%E7%9C%8B%E6%97%A5%E5%BF%97%E9%A1%BA%E6%89%8B%E7%9A%84%E5%8A%9E%E6%B3%95/107 "2026-10-05T05:42:00Z")

</div>

「看日志顺手的办法」。 能按请求编号过滤就够。不必上一整套平台。我先把编号打进每一行。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执…

---

## [垫高之后温度下来了，编译时间没变](https://buildx.do/t/%E5%9E%AB%E9%AB%98%E4%B9%8B%E5%90%8E%E6%B8%A9%E5%BA%A6%E4%B8%8B%E6%9D%A5%E4%BA%86%EF%BC%8C%E7%BC%96%E8%AF%91%E6%97%B6%E9%97%B4%E6%B2%A1%E5%8F%98/261)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 0\
**最近更新：:** [2026 年10 月 7 日 18:34 UTC](https://buildx.do/t/%E5%9E%AB%E9%AB%98%E4%B9%8B%E5%90%8E%E6%B8%A9%E5%BA%A6%E4%B8%8B%E6%9D%A5%E4%BA%86%EF%BC%8C%E7%BC%96%E8%AF%91%E6%97%B6%E9%97%B4%E6%B2%A1%E5%8F%98/261 "2026-10-07T18:34:00Z")

</div>

硬盘从 71 度到 58 度。编译还是那么久，所以慢不在温度。温度的好处是不再降频重启。下次别把‘变安静’写成‘变快’。

---

## [给新人的说明删掉了一半](https://buildx.do/t/%E7%BB%99%E6%96%B0%E4%BA%BA%E7%9A%84%E8%AF%B4%E6%98%8E%E5%88%A0%E6%8E%89%E4%BA%86%E4%B8%80%E5%8D%8A/267)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 0\
**最近更新：:** [2026 年10 月 9 日 02:16 UTC](https://buildx.do/t/%E7%BB%99%E6%96%B0%E4%BA%BA%E7%9A%84%E8%AF%B4%E6%98%8E%E5%88%A0%E6%8E%89%E4%BA%86%E4%B8%80%E5%8D%8A/267 "2026-10-09T02:16: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/%E9%85%8D%E7%BD%AE%E9%87%8C%E5%93%AA%E4%BA%9B%E8%83%BD%E5%8A%A8/98)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 01:44 UTC](https://buildx.do/t/%E9%85%8D%E7%BD%AE%E9%87%8C%E5%93%AA%E4%BA%9B%E8%83%BD%E5%8A%A8/98 "2026-10-05T01:44:00Z")

</div>

「配置里哪些能动」。 标注过的可以改。没标注的先别动。改之前复制一份旧的。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。给别人之前，…

---

## [下周有维护窗口](https://buildx.do/t/%E4%B8%8B%E5%91%A8%E6%9C%89%E7%BB%B4%E6%8A%A4%E7%AA%97%E5%8F%A3/154)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 05:56 UTC](https://buildx.do/t/%E4%B8%8B%E5%91%A8%E6%9C%89%E7%BB%B4%E6%8A%A4%E7%AA%97%E5%8F%A3/154 "2026-10-06T05:56:00Z")

</div>

「下周有维护窗口」。 写在日历上。别约在那段时间做发布。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或季度，不要在维护窗口里发布。 这次按时间写。…

---

## [安全更新建议这周看](https://buildx.do/t/%E5%AE%89%E5%85%A8%E6%9B%B4%E6%96%B0%E5%BB%BA%E8%AE%AE%E8%BF%99%E5%91%A8%E7%9C%8B/144)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 01:26 UTC](https://buildx.do/t/%E5%AE%89%E5%85%A8%E6%9B%B4%E6%96%B0%E5%BB%BA%E8%AE%AE%E8%BF%99%E5%91%A8%E7%9C%8B/144 "2026-10-06T01:26:00Z")

</div>

「安全更新建议这周看」。 不是吓人和紧急，是值得排进这周。发行说明写了影响范围。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明…

---

## [密钥曾经写进仓库](https://buildx.do/t/%E5%AF%86%E9%92%A5%E6%9B%BE%E7%BB%8F%E5%86%99%E8%BF%9B%E4%BB%93%E5%BA%93/27)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 12:42 UTC](https://buildx.do/t/%E5%AF%86%E9%92%A5%E6%9B%BE%E7%BB%8F%E5%86%99%E8%BF%9B%E4%BB%93%E5%BA%93/27 "2026-10-03T12:42:00Z")

</div>

提交前没看差异，把本地配置里的访问密钥一起推了上去。几分钟后才在提交记录里看见。 只删掉最新文件不够。历史里还能把那次提交检出来。我们没有改写所有人的历史，而是立刻把那把密钥作废，换了一把新的。 新密钥只放在本机和部署环境，仓库里改成示例文件，真实文件名写进忽略列表。 提交前多了一项检查：差异里如果出现密钥样式的长字符串，就停下来看。检查是脚本，不是记性。 我把这次经过写成短记录，放在仓库的开发说明里，不写密钥本身，只写‘作废、…

[上一页](https://buildx.do/latest.md?page=6)

[下一页](https://buildx.do/latest.md?page=8)
