# Latest

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

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

**Page:** 6

---

## [错误被吞掉了](https://buildx.do/t/%E9%94%99%E8%AF%AF%E8%A2%AB%E5%90%9E%E6%8E%89%E4%BA%86/43)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 21:14 UTC](https://buildx.do/t/%E9%94%99%E8%AF%AF%E8%A2%AB%E5%90%9E%E6%8E%89%E4%BA%86/43 "2026-10-03T21:14:00Z")

</div>

调用方收到成功，下游其实失败了。捕获错误的地方只写了一行空日志，没有原因，也没有继续抛出。 空日志等于没有日志。排查时只能看到‘成功’，和用户看到的失败对不上。 改成两种选择里的一种：要么把原因写进日志并返回失败，要么继续抛出交给上层统一处理。这里选了返回失败，因为上层已经有统一的错误格式。 补了测试。下游失败时，结果必须是失败，不能是成功。以前没有这条，所以吞掉错误的写法能通过测试。 我又搜了同类的空捕获。还有一处是故意忽略的…

---

## [给新同事的第一周](https://buildx.do/t/%E7%BB%99%E6%96%B0%E5%90%8C%E4%BA%8B%E7%9A%84%E7%AC%AC%E4%B8%80%E5%91%A8/103)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 03:34 UTC](https://buildx.do/t/%E7%BB%99%E6%96%B0%E5%90%8C%E4%BA%8B%E7%9A%84%E7%AC%AC%E4%B8%80%E5%91%A8/103 "2026-10-05T03:34:00Z")

</div>

「给新同事的第一周」。 能跑起来、能提交、知道去哪问。别第一天就塞整套架构。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放…

---

## [一件事一个地方做决定](https://buildx.do/t/%E4%B8%80%E4%BB%B6%E4%BA%8B%E4%B8%80%E4%B8%AA%E5%9C%B0%E6%96%B9%E5%81%9A%E5%86%B3%E5%AE%9A/196)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 04:20 UTC](https://buildx.do/t/%E4%B8%80%E4%BB%B6%E4%BA%8B%E4%B8%80%E4%B8%AA%E5%9C%B0%E6%96%B9%E5%81%9A%E5%86%B3%E5%AE%9A/196 "2026-10-07T04:20:00Z")

</div>

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

---

## [周末想线上一起读一段代码](https://buildx.do/t/%E5%91%A8%E6%9C%AB%E6%83%B3%E7%BA%BF%E4%B8%8A%E4%B8%80%E8%B5%B7%E8%AF%BB%E4%B8%80%E6%AE%B5%E4%BB%A3%E7%A0%81/167)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 12:52 UTC](https://buildx.do/t/%E5%91%A8%E6%9C%AB%E6%83%B3%E7%BA%BF%E4%B8%8A%E4%B8%80%E8%B5%B7%E8%AF%BB%E4%B8%80%E6%AE%B5%E4%BB%A3%E7%A0%81/167 "2026-10-06T12:52:00Z")

</div>

「周末想线上一起读一段代码」。 不用准备幻灯片。挑一个仓库里真实的函数，读一小时。有人想一起来吗？ 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 活动只为一件具体的事，时间写短。读代码就读一个真实函数，分享就讲一个问题。自我介绍两句就够：在写什么，卡在哪。结束后留下能查的记录，不只有当时的口头。不对的地…

---

## [显示器偏色](https://buildx.do/t/%E6%98%BE%E7%A4%BA%E5%99%A8%E5%81%8F%E8%89%B2/161)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 09:40 UTC](https://buildx.do/t/%E6%98%BE%E7%A4%BA%E5%99%A8%E5%81%8F%E8%89%B2/161 "2026-10-06T09:40:00Z")

</div>

「显示器偏色」。 看界面容易误判。校准之前，别在这台屏幕上定颜色。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电不稳，优先看，再重装系统。 给…

---

## [分支我们现在这样叫](https://buildx.do/t/%E5%88%86%E6%94%AF%E6%88%91%E4%BB%AC%E7%8E%B0%E5%9C%A8%E8%BF%99%E6%A0%B7%E5%8F%AB/100)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 01:58 UTC](https://buildx.do/t/%E5%88%86%E6%94%AF%E6%88%91%E4%BB%AC%E7%8E%B0%E5%9C%A8%E8%BF%99%E6%A0%B7%E5%8F%AB/100 "2026-10-05T01:58:00Z")

</div>

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

---

## [同一组请求跑了三次，数字才稳定](https://buildx.do/t/%E5%90%8C%E4%B8%80%E7%BB%84%E8%AF%B7%E6%B1%82%E8%B7%91%E4%BA%86%E4%B8%89%E6%AC%A1%EF%BC%8C%E6%95%B0%E5%AD%97%E6%89%8D%E7%A8%B3%E5%AE%9A/266)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 23:59 UTC](https://buildx.do/t/%E5%90%8C%E4%B8%80%E7%BB%84%E8%AF%B7%E6%B1%82%E8%B7%91%E4%BA%86%E4%B8%89%E6%AC%A1%EF%BC%8C%E6%95%B0%E5%AD%97%E6%89%8D%E7%A8%B3%E5%AE%9A/266 "2026-10-08T23:59:00Z")

</div>

第一次慢，第二次快，是缓存。第三次和第二次接近，才拿来当改前的底。只跑一次就写结论，会被热缓存骗。

---

## [许可证比以前严](https://buildx.do/t/%E8%AE%B8%E5%8F%AF%E8%AF%81%E6%AF%94%E4%BB%A5%E5%89%8D%E4%B8%A5/152)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 04:52 UTC](https://buildx.do/t/%E8%AE%B8%E5%8F%AF%E8%AF%81%E6%AF%94%E4%BB%A5%E5%89%8D%E4%B8%A5/152 "2026-10-06T04:52:00Z")

</div>

「许可证比以前严」。 内部用可能还行，分发要再看。让熟悉的人读一遍。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 动态只记会影响我们怎么用的那一部分：默认值变了、接口弃用了、协议变严了、维护窗口在哪天。不抄整份发布说明。升级前先搜自己有没有依赖旧行为。不紧急的排进周或季度，不要在维护窗口里发…

---

## [一个不依赖服务的小库](https://buildx.do/t/%E4%B8%80%E4%B8%AA%E4%B8%8D%E4%BE%9D%E8%B5%96%E6%9C%8D%E5%8A%A1%E7%9A%84%E5%B0%8F%E5%BA%93/141)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 23:50 UTC](https://buildx.do/t/%E4%B8%80%E4%B8%AA%E4%B8%8D%E4%BE%9D%E8%B5%96%E6%9C%8D%E5%8A%A1%E7%9A%84%E5%B0%8F%E5%BA%93/141 "2026-10-05T23:50:00Z")

</div>

「一个不依赖服务的小库」。 放进项目就能用。没有账号，没有联网。适合内部小脚本。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 展示的是一个能用的小东西，不是计划。写清楚它解决哪一件具体的事，输入是什么，输出是什么，什么情况下不要用。边界没做完就直说。主路径通了就可以给别人试，不必等…

---

## [有官方中文我就不再译](https://buildx.do/t/%E6%9C%89%E5%AE%98%E6%96%B9%E4%B8%AD%E6%96%87%E6%88%91%E5%B0%B1%E4%B8%8D%E5%86%8D%E8%AF%91/190)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 01:08 UTC](https://buildx.do/t/%E6%9C%89%E5%AE%98%E6%96%B9%E4%B8%AD%E6%96%87%E6%88%91%E5%B0%B1%E4%B8%8D%E5%86%8D%E8%AF%91/190 "2026-10-07T01:08:00Z")

</div>

「有官方中文我就不再译」。 重复一遍没有好处。这篇是因为还没有。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试。我的理解写在引用外面，不把猜测写成作者的话。原文后来改了，就把差异补在末尾，不…

---

## [浏览器一直吃旧脚本](https://buildx.do/t/%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%80%E7%9B%B4%E5%90%83%E6%97%A7%E8%84%9A%E6%9C%AC/33)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 15:54 UTC](https://buildx.do/t/%E6%B5%8F%E8%A7%88%E5%99%A8%E4%B8%80%E7%9B%B4%E5%90%83%E6%97%A7%E8%84%9A%E6%9C%AC/33 "2026-10-03T15:54:00Z")

</div>

脚本逻辑改了，浏览器里仍是旧行为。强制刷新有时有效，有时又回到旧的。 开发时先确认没有第二份旧服务。确认之后，如果仍是旧脚本，就是缓存。文件地址没变，浏览器认为可以继续用。 正式环境给脚本地址加上内容摘要。内容一变，地址就变，旧缓存用不上。 开发环境可以在浏览器里禁用缓存，但别让同事靠记忆做这件事。页脚打印脚本地址的摘要，两个人对一下就知道是不是同一份。 也遇到过页面是新的、脚本是旧的。那是页面没带上新的摘要。构建要保证页面和脚…

---

## [配置和密钥分开](https://buildx.do/t/%E9%85%8D%E7%BD%AE%E5%92%8C%E5%AF%86%E9%92%A5%E5%88%86%E5%BC%80/48)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 23:54 UTC](https://buildx.do/t/%E9%85%8D%E7%BD%AE%E5%92%8C%E5%AF%86%E9%92%A5%E5%88%86%E5%BC%80/48 "2026-10-03T23:54:00Z")

</div>

「配置和密钥分开」。 密钥不再跟清单放一起。改配置不用碰密钥。误提交的机会少了。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 先分清是没起来、起来了但检查失败，还是流量打到了正在退出的实例。就绪检查只打真正加载完的轻量路径，并给几…

---

## [旧客户端还在](https://buildx.do/t/%E6%97%A7%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%BF%98%E5%9C%A8/198)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 05:24 UTC](https://buildx.do/t/%E6%97%A7%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%BF%98%E5%9C%A8/198 "2026-10-07T05:24:00Z")

</div>

「旧客户端还在」。 接口不能说改就改。留一段时间，写明何时停止。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 先写不做什么。多一个组件就多一种故障，量不大就不要先加队列或缓存。每一层的等待时间写明，重试要有次数和间隔的上限。同一状…

---

## [密码不要写在脚本里](https://buildx.do/t/%E5%AF%86%E7%A0%81%E4%B8%8D%E8%A6%81%E5%86%99%E5%9C%A8%E8%84%9A%E6%9C%AC%E9%87%8C/221)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 16:50 UTC](https://buildx.do/t/%E5%AF%86%E7%A0%81%E4%B8%8D%E8%A6%81%E5%86%99%E5%9C%A8%E8%84%9A%E6%9C%AC%E9%87%8C/221 "2026-10-07T16:50:00Z")

</div>

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

---

## [只译了和日常有关的一半](https://buildx.do/t/%E5%8F%AA%E8%AF%91%E4%BA%86%E5%92%8C%E6%97%A5%E5%B8%B8%E6%9C%89%E5%85%B3%E7%9A%84%E4%B8%80%E5%8D%8A/186)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 23:00 UTC](https://buildx.do/t/%E5%8F%AA%E8%AF%91%E4%BA%86%E5%92%8C%E6%97%A5%E5%B8%B8%E6%9C%89%E5%85%B3%E7%9A%84%E4%B8%80%E5%8D%8A/186 "2026-10-06T23:00:00Z")

</div>

「只译了和日常有关的一半」。 另一半是他们内部的流程。对我们没用，就停了。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能…

---

## [小团队用得起的开源工具，按能停下来来选](https://buildx.do/t/%E5%B0%8F%E5%9B%A2%E9%98%9F%E7%94%A8%E5%BE%97%E8%B5%B7%E7%9A%84%E5%BC%80%E6%BA%90%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%8C%89%E8%83%BD%E5%81%9C%E4%B8%8B%E6%9D%A5%E6%9D%A5%E9%80%89/256)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 3\
**最近更新：:** [2026 年10 月 8 日 20:45 UTC](https://buildx.do/t/%E5%B0%8F%E5%9B%A2%E9%98%9F%E7%94%A8%E5%BE%97%E8%B5%B7%E7%9A%84%E5%BC%80%E6%BA%90%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%8C%89%E8%83%BD%E5%81%9C%E4%B8%8B%E6%9D%A5%E6%9D%A5%E9%80%89/256 "2026-10-08T20:45:00Z")

</div>

公益小组和兴趣小组最常见的问题不是缺一个大平台，而是工具一旦用上就停不掉，数据还拿不出来。选择时我只留三个问题：不注册能否试用，数据能否自己导出，没人维护时能否关掉。 文件协作可以看能自己托管的网盘类开源软件，重要的是备份和权限，不是功能数量。即时讨论如果只要文字房间，选能导出记录的，避免记录只活在某人的手机上。文档用开放格式，过两年还打得开。视频会议不必自建，但录下来的文件要有人负责字幕和存放位置。 不在这篇里比较价格，也不贴邀请码。免费档够用就写免费档怎么停。实验用的站点在名字里写上实验，用完删除。密码不要发在帖子里，写‘管理员单独交付’就够了。 如果你给一个真实的小组装过其中某样，…

---

## [做一半失败还能再跑](https://buildx.do/t/%E5%81%9A%E4%B8%80%E5%8D%8A%E5%A4%B1%E8%B4%A5%E8%BF%98%E8%83%BD%E5%86%8D%E8%B7%91/217)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 14:42 UTC](https://buildx.do/t/%E5%81%9A%E4%B8%80%E5%8D%8A%E5%A4%B1%E8%B4%A5%E8%BF%98%E8%83%BD%E5%86%8D%E8%B7%91/217 "2026-10-07T14:42:00Z")

</div>

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

---

## [第一次合进主干全是配置冲突](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 16:26 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E5%90%88%E8%BF%9B%E4%B8%BB%E5%B9%B2%E5%85%A8%E6%98%AF%E9%85%8D%E7%BD%AE%E5%86%B2%E7%AA%81/34 "2026-10-03T16:26:00Z")

</div>

业务代码几乎没有冲突，冲突全在配置：本机数据库地址、端口、一个只在我电脑上存在的路径。 这些值不该进主干。我们留了一份示例配置，真实配置写进忽略列表。每个人从示例复制一份再填。 已经进过主干的真实地址，从最新文件里拿掉，并在说明里写上‘不要再提交’。历史里的旧值如果还敏感，就按密钥那套作废，而不是假装没发生。 合入前看差异时，配置文件单独看一遍。业务代码的冲突可以慢慢对，配置冲突往往是有人把本地值交上来了。 示例文件里的值用明显…

---

## [例子改成了我们在用的语言](https://buildx.do/t/%E4%BE%8B%E5%AD%90%E6%94%B9%E6%88%90%E4%BA%86%E6%88%91%E4%BB%AC%E5%9C%A8%E7%94%A8%E7%9A%84%E8%AF%AD%E8%A8%80/181)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 20:20 UTC](https://buildx.do/t/%E4%BE%8B%E5%AD%90%E6%94%B9%E6%88%90%E4%BA%86%E6%88%91%E4%BB%AC%E5%9C%A8%E7%94%A8%E7%9A%84%E8%AF%AD%E8%A8%80/181 "2026-10-06T20:20:00Z")

</div>

「例子改成了我们在用的语言」。 原文是另一种。步骤没变。这样读的人能直接试。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试。我的理解写在引用外面，不把猜测写…

---

## [依赖一个不再维护的包](https://buildx.do/t/%E4%BE%9D%E8%B5%96%E4%B8%80%E4%B8%AA%E4%B8%8D%E5%86%8D%E7%BB%B4%E6%8A%A4%E7%9A%84%E5%8C%85/78)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 15:04 UTC](https://buildx.do/t/%E4%BE%9D%E8%B5%96%E4%B8%80%E4%B8%AA%E4%B8%8D%E5%86%8D%E7%BB%B4%E6%8A%A4%E7%9A%84%E5%8C%85/78 "2026-10-04T15:04:00Z")

</div>

「依赖一个不再维护的包」。 能跑，但安全更新没有了。列进待替换，不急着今天动。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划…

---

## [作者后来改了原文](https://buildx.do/t/%E4%BD%9C%E8%80%85%E5%90%8E%E6%9D%A5%E6%94%B9%E4%BA%86%E5%8E%9F%E6%96%87/187)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 23:32 UTC](https://buildx.do/t/%E4%BD%9C%E8%80%85%E5%90%8E%E6%9D%A5%E6%94%B9%E4%BA%86%E5%8E%9F%E6%96%87/187 "2026-10-06T23:32:00Z")

</div>

「作者后来改了原文」。 我补了差异在末尾。正文没悄悄改掉，免得对不上早先的讨论。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试。我的理解写在引用外面，不把猜…

---

## [硬盘温度高](https://buildx.do/t/%E7%A1%AC%E7%9B%98%E6%B8%A9%E5%BA%A6%E9%AB%98/164)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 11:16 UTC](https://buildx.do/t/%E7%A1%AC%E7%9B%98%E6%B8%A9%E5%BA%A6%E9%AB%98/164 "2026-10-06T11:16:00Z")

</div>

「硬盘温度高」。 垫高之后气流好一点。温度降下来，声音也小了。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电不稳，优先看，再重装系统。 …

---

## [先写不做什么](https://buildx.do/t/%E5%85%88%E5%86%99%E4%B8%8D%E5%81%9A%E4%BB%80%E4%B9%88/201)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [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 "2026-10-07T06:10: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/%E4%B8%A4%E4%B8%AA%E5%AE%B9%E5%99%A8%E4%BA%92%E7%9B%B8%E7%AD%89/70)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 10:48 UTC](https://buildx.do/t/%E4%B8%A4%E4%B8%AA%E5%AE%B9%E5%99%A8%E4%BA%92%E7%9B%B8%E7%AD%89/70 "2026-10-04T10:48:00Z")

</div>

「两个容器互相等」。 谁都要对方先起来。把真正的依赖写清楚，另一个改为可稍后连接。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印出来。端口先写明哪边对外。基础镜像版本写死，避免本地有的库线上没有。健康检查只用镜像里…

---

## [术语先不强求统一](https://buildx.do/t/%E6%9C%AF%E8%AF%AD%E5%85%88%E4%B8%8D%E5%BC%BA%E6%B1%82%E7%BB%9F%E4%B8%80/180)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 19:48 UTC](https://buildx.do/t/%E6%9C%AF%E8%AF%AD%E5%85%88%E4%B8%8D%E5%BC%BA%E6%B1%82%E7%BB%9F%E4%B8%80/180 "2026-10-06T19:48:00Z")

</div>

「术语先不强求统一」。 我在文末列了原文和我用的词。你有更顺的说法就改。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试…

---

## [接口模拟有免费档](https://buildx.do/t/%E6%8E%A5%E5%8F%A3%E6%A8%A1%E6%8B%9F%E6%9C%89%E5%85%8D%E8%B4%B9%E6%A1%A3/247)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 06:42 UTC](https://buildx.do/t/%E6%8E%A5%E5%8F%A3%E6%A8%A1%E6%8B%9F%E6%9C%89%E5%85%8D%E8%B4%B9%E6%A1%A3/247 "2026-10-08T06:42:00Z")

</div>

「接口模拟有免费档」。 本地把失败情形先模拟出来。够用很久。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 先写清个人或内部使用时怎么拿到、怎么用、用完怎么停。授权和适用方式放在链接旁边，用之前看一眼。练手不要用真实用户的数据。实验用的环境在名字里写明，用完就删。够用就…

---

## [旧笔记本合盖不休眠](https://buildx.do/t/%E6%97%A7%E7%AC%94%E8%AE%B0%E6%9C%AC%E5%90%88%E7%9B%96%E4%B8%8D%E4%BC%91%E7%9C%A0/163)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 10:44 UTC](https://buildx.do/t/%E6%97%A7%E7%AC%94%E8%AE%B0%E6%9C%AC%E5%90%88%E7%9B%96%E4%B8%8D%E4%BC%91%E7%9C%A0/163 "2026-10-06T10:44:00Z")

</div>

「旧笔记本合盖不休眠」。 当跳板机。合盖还在跑。电源计划里改的。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电…

---

## [闲置小主机当构建机](https://buildx.do/t/%E9%97%B2%E7%BD%AE%E5%B0%8F%E4%B8%BB%E6%9C%BA%E5%BD%93%E6%9E%84%E5%BB%BA%E6%9C%BA/155)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 06:28 UTC](https://buildx.do/t/%E9%97%B2%E7%BD%AE%E5%B0%8F%E4%B8%BB%E6%9C%BA%E5%BD%93%E6%9E%84%E5%BB%BA%E6%9C%BA/155 "2026-10-06T06:28:00Z")

</div>

「闲置小主机当构建机」。 吵一点，但自己的机器不被占满。编译丢到那台上。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电不稳，优先看，再重装系统。 …

---

## [换了网线](https://buildx.do/t/%E6%8D%A2%E4%BA%86%E7%BD%91%E7%BA%BF/160)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 09:08 UTC](https://buildx.do/t/%E6%8D%A2%E4%BA%86%E7%BD%91%E7%BA%BF/160 "2026-10-06T09:08:00Z")

</div>

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

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

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