# Latest

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

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

**Page:** 7

---

## [截图用系统自带](https://buildx.do/t/%E6%88%AA%E5%9B%BE%E7%94%A8%E7%B3%BB%E7%BB%9F%E8%87%AA%E5%B8%A6/117)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 11:02 UTC](https://buildx.do/t/%E6%88%AA%E5%9B%BE%E7%94%A8%E7%B3%BB%E7%BB%9F%E8%87%AA%E5%B8%A6/117 "2026-10-05T11:02:00Z")

</div>

「截图用系统自带」。 圈出关键的一行就好。不用专门的标注套件。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执行。 …

---

## [公开的安全公告值得订](https://buildx.do/t/%E5%85%AC%E5%BC%80%E7%9A%84%E5%AE%89%E5%85%A8%E5%85%AC%E5%91%8A%E5%80%BC%E5%BE%97%E8%AE%A2/249)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 07:46 UTC](https://buildx.do/t/%E5%85%AC%E5%BC%80%E7%9A%84%E5%AE%89%E5%85%A8%E5%85%AC%E5%91%8A%E5%80%BC%E5%BE%97%E8%AE%A2/249 "2026-10-08T07:46:00Z")

</div>

「公开的安全公告值得订」。 不用每天看。有影响你在用的东西时再读。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先写清个人或内部使用时怎么拿到、怎么用、用完怎么停。授权和适用方式放在链接旁边，用之前看一眼。练手不要用真实用户的数据。实验用的环境在名字里写明，用完就删。够用就停，不把…

---

## [端口映射看反了](https://buildx.do/t/%E7%AB%AF%E5%8F%A3%E6%98%A0%E5%B0%84%E7%9C%8B%E5%8F%8D%E4%BA%86/65)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 08:08 UTC](https://buildx.do/t/%E7%AB%AF%E5%8F%A3%E6%98%A0%E5%B0%84%E7%9C%8B%E5%8F%8D%E4%BA%86/65 "2026-10-04T08:08:00Z")

</div>

「端口映射看反了」。 写成了容器里面的端口对到同一个数字，其实外面要另一个。先写明哪边是对外的。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印出来。端口先写明哪边对外。基础镜像版本写死，避免本地有的库线上没有。健康…

---

## [注释还写着旧参数](https://buildx.do/t/%E6%B3%A8%E9%87%8A%E8%BF%98%E5%86%99%E7%9D%80%E6%97%A7%E5%8F%82%E6%95%B0/41)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 20:10 UTC](https://buildx.do/t/%E6%B3%A8%E9%87%8A%E8%BF%98%E5%86%99%E7%9D%80%E6%97%A7%E5%8F%82%E6%95%B0/41 "2026-10-03T20:10:00Z")

</div>

我按注释里的参数名去传，接口说没有这个参数。代码里的名字半年前就换了，注释没改。 过期注释比没有注释更费时间。没有注释我会去读代码，有错注释我会先相信它。 这次把注释改成新名字，并搜了一遍旧名字。提示文案、示例、测试描述里还各有一处。 约定改成：改参数名的提交里，必须包含对旧名字的搜索。搜索没有结果再提交。 这个约定写在贡献说明的三行里，不写成很长的规范。越长越没有人在提交前看。 之后我又碰到一次旧名字，是在另一份仓库的示例里…

---

## [有个词我改了三次](https://buildx.do/t/%E6%9C%89%E4%B8%AA%E8%AF%8D%E6%88%91%E6%94%B9%E4%BA%86%E4%B8%89%E6%AC%A1/262)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 02:51 UTC](https://buildx.do/t/%E6%9C%89%E4%B8%AA%E8%AF%8D%E6%88%91%E6%94%B9%E4%BA%86%E4%B8%89%E6%AC%A1/262 "2026-10-08T02:51:00Z")

</div>

原文是 eventual。我先写成‘最终’，读起来像结束。改成‘迟早会一致’，句子长了，但不会理解成已经完成。还有更短的说法就直接改。

---

## [证书可以自动续](https://buildx.do/t/%E8%AF%81%E4%B9%A6%E5%8F%AF%E4%BB%A5%E8%87%AA%E5%8A%A8%E7%BB%AD/245)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 05:38 UTC](https://buildx.do/t/%E8%AF%81%E4%B9%A6%E5%8F%AF%E4%BB%A5%E8%87%AA%E5%8A%A8%E7%BB%AD/245 "2026-10-08T05:38:00Z")

</div>

「证书可以自动续」。 别手点。过期那天通常是半夜。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 先写清个人或内部使用时怎么拿到、怎么用、用完怎么停。授权和适用方式放在链接旁边，用之前看一眼。练手不要用真实用户的数据。实验用的环境在名字里写明，用完就删。够用就停，不把一篇推荐写成采购清单。 给后来的人…

---

## [猜的和验证过的分开写](https://buildx.do/t/%E7%8C%9C%E7%9A%84%E5%92%8C%E9%AA%8C%E8%AF%81%E8%BF%87%E7%9A%84%E5%88%86%E5%BC%80%E5%86%99/93)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 23:04 UTC](https://buildx.do/t/%E7%8C%9C%E7%9A%84%E5%92%8C%E9%AA%8C%E8%AF%81%E8%BF%87%E7%9A%84%E5%88%86%E5%BC%80%E5%86%99/93 "2026-10-04T23:04:00Z")

</div>

「猜的和验证过的分开写」。 笔记里混在一起，第二天会把猜测当成事实。我现在分成两节。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先把发布时间、改配置的时间、第一次报错的时间写在一起，再猜原因。拒绝和找不到是两种错。只有一台机器出问题，先对时和看这台机器的配置。把超时加长常常只是把…

---

## [只需要一个小功能](https://buildx.do/t/%E5%8F%AA%E9%9C%80%E8%A6%81%E4%B8%80%E4%B8%AA%E5%B0%8F%E5%8A%9F%E8%83%BD/74)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 12:56 UTC](https://buildx.do/t/%E5%8F%AA%E9%9C%80%E8%A6%81%E4%B8%80%E4%B8%AA%E5%B0%8F%E5%8A%9F%E8%83%BD/74 "2026-10-04T12:56:00Z")

</div>

「只需要一个小功能」。 为了它引进一整套，不划算。自己写二十行，比背一整套概念轻松。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。给上游…

---

## [每天的检查写成脚本](https://buildx.do/t/%E6%AF%8F%E5%A4%A9%E7%9A%84%E6%A3%80%E6%9F%A5%E5%86%99%E6%88%90%E8%84%9A%E6%9C%AC/215)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 13:38 UTC](https://buildx.do/t/%E6%AF%8F%E5%A4%A9%E7%9A%84%E6%A3%80%E6%9F%A5%E5%86%99%E6%88%90%E8%84%9A%E6%9C%AC/215 "2026-10-07T13:38:00Z")

</div>

「每天的检查写成脚本」。 眼睛会漏。脚本会按同样的顺序看。失败才叫我。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 脚本要敢再跑一次：空参数直接退出，做完的步骤跳过，失败用非零退出码。真正修改之前先打印将要做什么。密码和家目录路径不要写死。日志追加到固定文件，定时跑失败才有人能看见。文件开头写清参数和…

---

## [这个版本改了默认超时](https://buildx.do/t/%E8%BF%99%E4%B8%AA%E7%89%88%E6%9C%AC%E6%94%B9%E4%BA%86%E9%BB%98%E8%AE%A4%E8%B6%85%E6%97%B6/143)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 00:54 UTC](https://buildx.do/t/%E8%BF%99%E4%B8%AA%E7%89%88%E6%9C%AC%E6%94%B9%E4%BA%86%E9%BB%98%E8%AE%A4%E8%B6%85%E6%97%B6/143 "2026-10-06T00:54:00Z")

</div>

「这个版本改了默认超时」。 旧的默认不再适用。升级前看一下自己有没有依赖旧行为。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或季度，不要在维护窗口里…

---

## [大文件传到九成断开](https://buildx.do/t/%E5%A4%A7%E6%96%87%E4%BB%B6%E4%BC%A0%E5%88%B0%E4%B9%9D%E6%88%90%E6%96%AD%E5%BC%80/123)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 14:14 UTC](https://buildx.do/t/%E5%A4%A7%E6%96%87%E4%BB%B6%E4%BC%A0%E5%88%B0%E4%B9%9D%E6%88%90%E6%96%AD%E5%BC%80/123 "2026-10-05T14:14:00Z")

</div>

「大文件传到九成断开」。 小文件正常。是限制，还是超时？我把大小和耗时写在下面。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 提问时写四样：你做了什么，期望什么，实际什么，已经排除了什么。日志贴关键的一段，不要整文件。能缩小范围的对比写出来，例如只有空库失败、只有一台机器失败、只有…

---

## [定时跑失败要留下痕迹](https://buildx.do/t/%E5%AE%9A%E6%97%B6%E8%B7%91%E5%A4%B1%E8%B4%A5%E8%A6%81%E7%95%99%E4%B8%8B%E7%97%95%E8%BF%B9/226)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 19:30 UTC](https://buildx.do/t/%E5%AE%9A%E6%97%B6%E8%B7%91%E5%A4%B1%E8%B4%A5%E8%A6%81%E7%95%99%E4%B8%8B%E7%97%95%E8%BF%B9/226 "2026-10-07T19:30:00Z")

</div>

「定时跑失败要留下痕迹」。 只在当时打印，没人看见。写到固定的日志里。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 脚本要敢再跑一次：空参数直接退出，做完的步骤跳过，失败用非零退出码。真正修改之前先打印将要做什么。密码和家目录路径不要写死。日志追加到固定文件，定时跑失败才有人能看见。文件开头写清参数和…

---

## [看端口占用](https://buildx.do/t/%E7%9C%8B%E7%AB%AF%E5%8F%A3%E5%8D%A0%E7%94%A8/114)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 09:26 UTC](https://buildx.do/t/%E7%9C%8B%E7%AB%AF%E5%8F%A3%E5%8D%A0%E7%94%A8/114 "2026-10-05T09:26:00Z")

</div>

「看端口占用」。 成为习惯之后，少了很多‘我明明关了’。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开…

---

## [放在笔记里方便别人改](https://buildx.do/t/%E6%94%BE%E5%9C%A8%E7%AC%94%E8%AE%B0%E9%87%8C%E6%96%B9%E4%BE%BF%E5%88%AB%E4%BA%BA%E6%94%B9/188)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 00:04 UTC](https://buildx.do/t/%E6%94%BE%E5%9C%A8%E7%AC%94%E8%AE%B0%E9%87%8C%E6%96%B9%E4%BE%BF%E5%88%AB%E4%BA%BA%E6%94%B9/188 "2026-10-07T00:04:00Z")

</div>

「放在笔记里方便别人改」。 别只留在我自己的草稿。错了就能看见。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试。我的理解写在引用外面，不把猜测写成作者的话。原文后来改了，就把差异补…

---

## [本地和线上的结构怎么对](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E5%92%8C%E7%BA%BF%E4%B8%8A%E7%9A%84%E7%BB%93%E6%9E%84%E6%80%8E%E4%B9%88%E5%AF%B9/102)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 03:02 UTC](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E5%92%8C%E7%BA%BF%E4%B8%8A%E7%9A%84%E7%BB%93%E6%9E%84%E6%80%8E%E4%B9%88%E5%AF%B9/102 "2026-10-05T03:02:00Z")

</div>

「本地和线上的结构怎么对」。 别用眼睛比。导出两边的字段列表。差一列往往就是故障本身。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、…

---

## [镜像里别留安装缓存](https://buildx.do/t/%E9%95%9C%E5%83%8F%E9%87%8C%E5%88%AB%E7%95%99%E5%AE%89%E8%A3%85%E7%BC%93%E5%AD%98/59)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 04:56 UTC](https://buildx.do/t/%E9%95%9C%E5%83%8F%E9%87%8C%E5%88%AB%E7%95%99%E5%AE%89%E8%A3%85%E7%BC%93%E5%AD%98/59 "2026-10-04T04:56:00Z")

</div>

「镜像里别留安装缓存」。 体积大，也没必要。构建最后清掉。拉取快了一截。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印出来。端口先写明哪边对外。基础镜像版本写死，避免本地有的库线上没有。健康检查只用镜像里存在的命令…

---

## [说明写在仓库里](https://buildx.do/t/%E8%AF%B4%E6%98%8E%E5%86%99%E5%9C%A8%E4%BB%93%E5%BA%93%E9%87%8C/106)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 05:10 UTC](https://buildx.do/t/%E8%AF%B4%E6%98%8E%E5%86%99%E5%9C%A8%E4%BB%93%E5%BA%93%E9%87%8C/106 "2026-10-05T05:10:00Z")

</div>

「说明写在仓库里」。 聊天记录会沉。仓库里的说明还在。短一点也比没有强。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。给别人之前，在干净目录自…

---

## [机器放进柜子](https://buildx.do/t/%E6%9C%BA%E5%99%A8%E6%94%BE%E8%BF%9B%E6%9F%9C%E5%AD%90/166)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 12:20 UTC](https://buildx.do/t/%E6%9C%BA%E5%99%A8%E6%94%BE%E8%BF%9B%E6%9F%9C%E5%AD%90/166 "2026-10-06T12:20:00Z")

</div>

「机器放进柜子」。 记得留出风口。我曾经放满，结果过热降频。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电不稳，优先看，再重装系统。 这次按时…

---

## [只给自己用的书签页](https://buildx.do/t/%E5%8F%AA%E7%BB%99%E8%87%AA%E5%B7%B1%E7%94%A8%E7%9A%84%E4%B9%A6%E7%AD%BE%E9%A1%B5/133)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 19:34 UTC](https://buildx.do/t/%E5%8F%AA%E7%BB%99%E8%87%AA%E5%B7%B1%E7%94%A8%E7%9A%84%E4%B9%A6%E7%AD%BE%E9%A1%B5/133 "2026-10-05T19:34:00Z")

</div>

「只给自己用的书签页」。 按项目分组。没有账号体系。够自己用。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 展示的是一个能用的小东西，不是计划。写清楚它解决哪一件具体的事，输入是什么，输出是什么，什么情况下不要用。边界没做完就直说。主路径通了就可以给别人试，不必等所有…

---

## [本地模拟上游失败](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E6%A8%A1%E6%8B%9F%E4%B8%8A%E6%B8%B8%E5%A4%B1%E8%B4%A5/113)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 08:54 UTC](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E6%A8%A1%E6%8B%9F%E4%B8%8A%E6%B8%B8%E5%A4%B1%E8%B4%A5/113 "2026-10-05T08:54:00Z")

</div>

「本地模拟上游失败」。 让上游返回错误，看自己的提示是否还像人话。比等真正故障有用。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执行…

---

## [连接池太小](https://buildx.do/t/%E8%BF%9E%E6%8E%A5%E6%B1%A0%E5%A4%AA%E5%B0%8F/209)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 10:26 UTC](https://buildx.do/t/%E8%BF%9E%E6%8E%A5%E6%B1%A0%E5%A4%AA%E5%B0%8F/209 "2026-10-07T10:26:00Z")

</div>

「连接池太小」。 高峰都在排队等连接。池子加大之后，等待消失。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命中率。索引让写入变慢如果可以接受，就写进备注，避免以后被人删掉。日志太细本身也会变慢。 …

---

## [找慢请求](https://buildx.do/t/%E6%89%BE%E6%85%A2%E8%AF%B7%E6%B1%82/111)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 07:50 UTC](https://buildx.do/t/%E6%89%BE%E6%85%A2%E8%AF%B7%E6%B1%82/111 "2026-10-05T07:50:00Z")

</div>

「找慢请求」。 先看访问记录里最慢的二十条。往往集中在一个地址。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执行…

---

## [待办放在仓库](https://buildx.do/t/%E5%BE%85%E5%8A%9E%E6%94%BE%E5%9C%A8%E4%BB%93%E5%BA%93/116)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 10:30 UTC](https://buildx.do/t/%E5%BE%85%E5%8A%9E%E6%94%BE%E5%9C%A8%E4%BB%93%E5%BA%93/116 "2026-10-05T10:30:00Z")

</div>

「待办放在仓库」。 日历提醒会忘在私人账号里。仓库里的清单大家都能看。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执行。 …

---

## [任务偶发跑两次](https://buildx.do/t/%E4%BB%BB%E5%8A%A1%E5%81%B6%E5%8F%91%E8%B7%91%E4%B8%A4%E6%AC%A1/122)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 13:42 UTC](https://buildx.do/t/%E4%BB%BB%E5%8A%A1%E5%81%B6%E5%8F%91%E8%B7%91%E4%B8%A4%E6%AC%A1/122 "2026-10-05T13:42:00Z")

</div>

「任务偶发跑两次」。 不是每次。像是超时之后又投了一次。怎样判断已经跑过，大家怎么做？ 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 提问时写四样：你做了什么，期望什么，实际什么，已经排除了什么。日志贴关键的一段，不要整文件。能缩小范围的对比写出来，例如只有空库失败、只有一台机器失败、只有大文…

---

## [回调到了，状态没变](https://buildx.do/t/%E5%9B%9E%E8%B0%83%E5%88%B0%E4%BA%86%EF%BC%8C%E7%8A%B6%E6%80%81%E6%B2%A1%E5%8F%98/120)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 12:38 UTC](https://buildx.do/t/%E5%9B%9E%E8%B0%83%E5%88%B0%E4%BA%86%EF%BC%8C%E7%8A%B6%E6%80%81%E6%B2%A1%E5%8F%98/120 "2026-10-05T12:38:00Z")

</div>

「回调到了，状态没变」。 日志里有收到，库里还是旧状态。中间像是返回早了。有人见过这种提前返回吗？ 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 提问时写四样：你做了什么，期望什么，实际什么，已经排除了什么。日志贴关键的一段，不要整…

---

## [把一篇教程改成读屏和键盘也能跟着做](https://buildx.do/t/%E6%8A%8A%E4%B8%80%E7%AF%87%E6%95%99%E7%A8%8B%E6%94%B9%E6%88%90%E8%AF%BB%E5%B1%8F%E5%92%8C%E9%94%AE%E7%9B%98%E4%B9%9F%E8%83%BD%E8%B7%9F%E7%9D%80%E5%81%9A/257)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 4\
**最近更新：:** [2026 年10 月 8 日 22:20 UTC](https://buildx.do/t/%E6%8A%8A%E4%B8%80%E7%AF%87%E6%95%99%E7%A8%8B%E6%94%B9%E6%88%90%E8%AF%BB%E5%B1%8F%E5%92%8C%E9%94%AE%E7%9B%98%E4%B9%9F%E8%83%BD%E8%B7%9F%E7%9D%80%E5%81%9A/257 "2026-10-08T22:20:00Z")

</div>

很多教程的步骤在截图里。看得见的人能猜，读屏的人只能听到‘图’。键盘用户则可能根本到不了截图里的那个按钮。把一篇已有教程改到能跟着做，是一件边界清楚的公益活。 做法是把每张关键图写成一句话：这一步在界面的哪个区域，控件叫什么，完成后出现什么文字。控件名要用界面上真实的名字，不要写‘点那个蓝色的’。蓝色对读屏没有意义，对色弱的人也不稳定。然后自己只靠键盘走一遍：Tab 能否到达，回车能否执行，做完焦点落在哪里。 改完在文末加三行：替代文字补了哪些，键盘走不通的还剩哪一步，原作者是否同意改版。不同意就另开一篇并链回原文，不要悄悄改别人的文章。 这是教程的改写说明，不是新的课程。一次改一篇就够…

---

## [新的长期支持版本有日期了](https://buildx.do/t/%E6%96%B0%E7%9A%84%E9%95%BF%E6%9C%9F%E6%94%AF%E6%8C%81%E7%89%88%E6%9C%AC%E6%9C%89%E6%97%A5%E6%9C%9F%E4%BA%86/151)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 04:20 UTC](https://buildx.do/t/%E6%96%B0%E7%9A%84%E9%95%BF%E6%9C%9F%E6%94%AF%E6%8C%81%E7%89%88%E6%9C%AC%E6%9C%89%E6%97%A5%E6%9C%9F%E4%BA%86/151 "2026-10-06T04:20:00Z")

</div>

「新的长期支持版本有日期了」。 团队可以排进下个季度，不必这周就动。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或…

---

## [空值把范围改宽了](https://buildx.do/t/%E7%A9%BA%E5%80%BC%E6%8A%8A%E8%8C%83%E5%9B%B4%E6%94%B9%E5%AE%BD%E4%BA%86/216)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 14:10 UTC](https://buildx.do/t/%E7%A9%BA%E5%80%BC%E6%8A%8A%E8%8C%83%E5%9B%B4%E6%94%B9%E5%AE%BD%E4%BA%86/216 "2026-10-07T14:10:00Z")

</div>

「空值把范围改宽了」。 参数没校验。现在空值直接退出，并告诉你缺什么。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 脚本要敢再跑一次：空参数直接退出，做完的步骤跳过，失败用非零退出码。真正修改之前先打印将要做什么。密码和家目录路径…

---

## [公开的示例数据](https://buildx.do/t/%E5%85%AC%E5%BC%80%E7%9A%84%E7%A4%BA%E4%BE%8B%E6%95%B0%E6%8D%AE/242)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 04:02 UTC](https://buildx.do/t/%E5%85%AC%E5%BC%80%E7%9A%84%E7%A4%BA%E4%BE%8B%E6%95%B0%E6%8D%AE/242 "2026-10-08T04:02:00Z")

</div>

「公开的示例数据」。 练导入和分页正好。不要拿真实用户的数据练。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 先写清个人或内部使用时怎么拿到、怎么用、用完怎么停。授权和适用方式放在链接旁边，用之前看一眼。练手不要用真实用户的数据。实验用的环境在名字里写明，用完就删。够用就停，不把一篇推荐写成…

---

## [干净目录装失败，锁文件是有的](https://buildx.do/t/%E5%B9%B2%E5%87%80%E7%9B%AE%E5%BD%95%E8%A3%85%E5%A4%B1%E8%B4%A5%EF%BC%8C%E9%94%81%E6%96%87%E4%BB%B6%E6%98%AF%E6%9C%89%E7%9A%84/260)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 16:17 UTC](https://buildx.do/t/%E5%B9%B2%E5%87%80%E7%9B%AE%E5%BD%95%E8%A3%85%E5%A4%B1%E8%B4%A5%EF%BC%8C%E9%94%81%E6%96%87%E4%BB%B6%E6%98%AF%E6%9C%89%E7%9A%84/260 "2026-10-07T16:17:00Z")

</div>

锁文件在。干净目录还是失败，卡在一个私有源。我把源地址涂掉了，错误是 401。这是权限，不是版本。有人用过只读令牌吗？令牌怎么放我不问，我想知道该看哪一层。

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

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