# Latest

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

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

**Page:** 3

---

## [NVDA 这份开源读屏，维护者能帮上什么](https://buildx.do/t/nvda-%E8%BF%99%E4%BB%BD%E5%BC%80%E6%BA%90%E8%AF%BB%E5%B1%8F%EF%BC%8C%E7%BB%B4%E6%8A%A4%E8%80%85%E8%83%BD%E5%B8%AE%E4%B8%8A%E4%BB%80%E4%B9%88/252)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 3\
**最近更新：:** [2026 年10 月 8 日 16:45 UTC](https://buildx.do/t/nvda-%E8%BF%99%E4%BB%BD%E5%BC%80%E6%BA%90%E8%AF%BB%E5%B1%8F%EF%BC%8C%E7%BB%B4%E6%8A%A4%E8%80%85%E8%83%BD%E5%B8%AE%E4%B8%8A%E4%BB%80%E4%B9%88/252 "2026-10-08T16:45:00Z")

</div>

NVDA 是 NV Access 维护的开源屏幕阅读器，Windows 上很多视障用户靠它读网页和软件。它不是一个‘装上就结束’的演示。读屏要跟着浏览器和系统更新，发音、焦点和快捷键都会出问题。 用不到读屏的人，仍然可以做几件具体的事。一是自己的网页不要抢走焦点，不要在没有提示的情况下刷新整页。二是按钮不要只放图标。三是如果项目文档只有图，补上文字步骤。四是遇到 NVDA 读错的开源组件，去它的问题列表看是否已有人报告，有的话补上你的版本和页面结构，而不是另开一个空问题。 公开活动里也有维护者留出时间回答 NVDA 的用法，说明这件工具是靠持续的人和问题列表活着的。我们不必假装自己会改读屏…

---

## [别把地址写死](https://buildx.do/t/%E5%88%AB%E6%8A%8A%E5%9C%B0%E5%9D%80%E5%86%99%E6%AD%BB/56)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 03:20 UTC](https://buildx.do/t/%E5%88%AB%E6%8A%8A%E5%9C%B0%E5%9D%80%E5%86%99%E6%AD%BB/56 "2026-10-04T03:20:00Z")

</div>

「别把地址写死」。 用服务名。环境一换，写死的地址就全部失效。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 先分清是没起来、起来了但检查失败，还是流量打到了正在退出的实例。就绪检查只打真正加载完的轻量路径，并给几秒宽限。配置和密钥分开，改完写明要不要重启。地址用服务名。清单从测试抄到生产时，…

---

## [选之前看最后一次提交](https://buildx.do/t/%E9%80%89%E4%B9%8B%E5%89%8D%E7%9C%8B%E6%9C%80%E5%90%8E%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4/71)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 11:20 UTC](https://buildx.do/t/%E9%80%89%E4%B9%8B%E5%89%8D%E7%9C%8B%E6%9C%80%E5%90%8E%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4/71 "2026-10-04T11:20:00Z")

</div>

「选之前看最后一次提交」。 文档还在，仓库已经半年没动。能用，但出了问题不一定有人接。我改选了一个还在更新的。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文…

---

## [慢在组装结果，不在查询](https://buildx.do/t/%E6%85%A2%E5%9C%A8%E7%BB%84%E8%A3%85%E7%BB%93%E6%9E%9C%EF%BC%8C%E4%B8%8D%E5%9C%A8%E6%9F%A5%E8%AF%A2/203)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 07:14 UTC](https://buildx.do/t/%E6%85%A2%E5%9C%A8%E7%BB%84%E8%A3%85%E7%BB%93%E6%9E%9C%EF%BC%8C%E4%B8%8D%E5%9C%A8%E6%9F%A5%E8%AF%A2/203 "2026-10-07T07:14:00Z")

</div>

「慢在组装结果，不在查询」。 查询几毫秒，把结果拼成响应花了大头。先量，再决定优化哪段。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命中率。索引让写入变慢如果可以接受，就写进备注，避免以后被人删…

---

## [月中小分享，题目不限](https://buildx.do/t/%E6%9C%88%E4%B8%AD%E5%B0%8F%E5%88%86%E4%BA%AB%EF%BC%8C%E9%A2%98%E7%9B%AE%E4%B8%8D%E9%99%90/171)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 15:00 UTC](https://buildx.do/t/%E6%9C%88%E4%B8%AD%E5%B0%8F%E5%88%86%E4%BA%AB%EF%BC%8C%E9%A2%98%E7%9B%AE%E4%B8%8D%E9%99%90/171 "2026-10-06T15:00:00Z")

</div>

「月中小分享，题目不限」。 十五分钟。一个具体问题。讲完留时间问。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 活动只为一件具体的事，时间写短。读代码就读一个真实函数，分享就讲一个问题。自我介绍两句就够：在写什么，卡在哪。结束后留下能查的记录，不只有当时的口头。不对的地方直接说，只…

---

## [提请求前读贡献说明](https://buildx.do/t/%E6%8F%90%E8%AF%B7%E6%B1%82%E5%89%8D%E8%AF%BB%E8%B4%A1%E7%8C%AE%E8%AF%B4%E6%98%8E/81)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 16:40 UTC](https://buildx.do/t/%E6%8F%90%E8%AF%B7%E6%B1%82%E5%89%8D%E8%AF%BB%E8%B4%A1%E7%8C%AE%E8%AF%B4%E6%98%8E/81 "2026-10-04T16:40:00Z")

</div>

「提请求前读贡献说明」。 他们要测试和一种提交格式。按着做，来回少了一轮。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。给上游…

---

## [怎么读一份接口说明](https://buildx.do/t/%E6%80%8E%E4%B9%88%E8%AF%BB%E4%B8%80%E4%BB%BD%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E/97)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 01:12 UTC](https://buildx.do/t/%E6%80%8E%E4%B9%88%E8%AF%BB%E4%B8%80%E4%BB%BD%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E/97 "2026-10-05T01:12:00Z")

</div>

「怎么读一份接口说明」。 先看地址和例子，再看错误时返回什么。别从第一段背景读起。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里…

---

## [内部接口的说明页](https://buildx.do/t/%E5%86%85%E9%83%A8%E6%8E%A5%E5%8F%A3%E7%9A%84%E8%AF%B4%E6%98%8E%E9%A1%B5/135)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 20:38 UTC](https://buildx.do/t/%E5%86%85%E9%83%A8%E6%8E%A5%E5%8F%A3%E7%9A%84%E8%AF%B4%E6%98%8E%E9%A1%B5/135 "2026-10-05T20:38:00Z")

</div>

「内部接口的说明页」。 例子和错误放在一起。新人不用再来问基础地址。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 展示的是一个能用的小东西，不是计划。写清楚它解决哪一件具体的事，输入是什么，输出是什么，什么情况下不要用。边界没做完就直说。主路径通了就可以给别人试，不必等所有边角都齐…

---

## [两个人同时改表结构](https://buildx.do/t/%E4%B8%A4%E4%B8%AA%E4%BA%BA%E5%90%8C%E6%97%B6%E6%94%B9%E8%A1%A8%E7%BB%93%E6%9E%84/28)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 13:14 UTC](https://buildx.do/t/%E4%B8%A4%E4%B8%AA%E4%BA%BA%E5%90%8C%E6%97%B6%E6%94%B9%E8%A1%A8%E7%BB%93%E6%9E%84/28 "2026-10-03T13:14:00Z")

</div>

我给表加了一列，另一位同事在同一天重命名了旁边一列。两边本地都迁移成功，合到一起时顺序和列名对不上。 冲突不在业务代码，在两份迁移文件。数据库只能按实际执行过的顺序来，不能按我们心里的顺序。 处理是先确定谁的迁移已经在共享环境跑过。跑过的那份保持文件名不变，另一份改成更晚的时间戳，并按新列名重写。 约定从此写在说明里：要改表结构，先在共享频道发一句文件名，再动手。同时改同一张表就错开，或者结对做一份迁移。 合完之后用一份干净库从…

---

## [魔法数字提出来之后](https://buildx.do/t/%E9%AD%94%E6%B3%95%E6%95%B0%E5%AD%97%E6%8F%90%E5%87%BA%E6%9D%A5%E4%B9%8B%E5%90%8E/38)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 18:34 UTC](https://buildx.do/t/%E9%AD%94%E6%B3%95%E6%95%B0%E5%AD%97%E6%8F%90%E5%87%BA%E6%9D%A5%E4%B9%8B%E5%90%8E/38 "2026-10-03T18:34:00Z")

</div>

超时 5 秒、重试 3 次，在三个文件里各写了一遍。改超时的人只找到两处，第三处仍是 5 秒，故障表现成‘有的请求快失败，有的会多等’。 收到一处常量里，三处都引用它。数字本身没变，变的是以后只会改一个地方。 常量旁边写了单位和原因。5 秒是给上游的响应时间，不是随便写的。没有这句话，下次还会有人改成 30 秒来‘消除失败’。 测试里也不再写死 5。用同一个常量，避免测试和生产各说各的。 我用搜索确认仓库里没有留下裸的 5 秒和…

---

## [开源项目把无障碍写进维护清单，值得看的公开做法](https://buildx.do/t/%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E6%8A%8A%E6%97%A0%E9%9A%9C%E7%A2%8D%E5%86%99%E8%BF%9B%E7%BB%B4%E6%8A%A4%E6%B8%85%E5%8D%95%EF%BC%8C%E5%80%BC%E5%BE%97%E7%9C%8B%E7%9A%84%E5%85%AC%E5%BC%80%E5%81%9A%E6%B3%95/253)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 3\
**最近更新：:** [2026 年10 月 8 日 17:45 UTC](https://buildx.do/t/%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E6%8A%8A%E6%97%A0%E9%9A%9C%E7%A2%8D%E5%86%99%E8%BF%9B%E7%BB%B4%E6%8A%A4%E6%B8%85%E5%8D%95%EF%BC%8C%E5%80%BC%E5%BE%97%E7%9C%8B%E7%9A%84%E5%85%AC%E5%BC%80%E5%81%9A%E6%B3%95/253 "2026-10-08T17:45:00Z")

</div>

最近公开的维护者材料里，有一条很实在：无障碍不要只放在欢迎页。GitHub 一侧的记录提到，他们把辅助技术黑客松、维护者文档和持续集成里的检查放在一起，并指向 opensource.guide 上的无障碍实践。峰会讨论过的优先问题，也留在公开的 open-source-accessibility 讨论里，而不是停在一场活动。 对我们这种刚开始的社区，用得上的不是再办一场大会，而是把同样的结构缩小。仓库或版规里写明：图片有替代文字，键盘能完成主路径，问题列表接受‘读屏读不懂’这一类报告。检查可以很笨，比如发版前有人真正用键盘发一次帖。 自动化规则可以帮忙。公开的网站审计工具把无障碍列成几十条…

---

## [日志太细本身变慢](https://buildx.do/t/%E6%97%A5%E5%BF%97%E5%A4%AA%E7%BB%86%E6%9C%AC%E8%BA%AB%E5%8F%98%E6%85%A2/213)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 12:34 UTC](https://buildx.do/t/%E6%97%A5%E5%BF%97%E5%A4%AA%E7%BB%86%E6%9C%AC%E8%BA%AB%E5%8F%98%E6%85%A2/213 "2026-10-07T12:34:00Z")

</div>

「日志太细本身变慢」。 关掉无用的调试输出，延迟下来一截。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 改之前先记下数字，用同一组请求跑前后各一次。先分清慢在查询、组装还是等待连接。看缓存要看具体的键，不要只看命中率。索引让写入变慢如果可以接受，就写进备注，避免以后被人删掉。日志太…

---

## [定时任务跑了两份](https://buildx.do/t/%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1%E8%B7%91%E4%BA%86%E4%B8%A4%E4%BB%BD/126)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 15:50 UTC](https://buildx.do/t/%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1%E8%B7%91%E4%BA%86%E4%B8%A4%E4%BB%BD/126 "2026-10-05T15:50:00Z")

</div>

「定时任务跑了两份」。 两台机器都执行了。怎样保证只有一份在跑？ 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 提问时写四样：你做了什么，期望什么，实际什么，已经排除了什么。日志贴关键的一段，不要整文件。能缩小范围的对比写出来，例如…

---

## [登录过一会儿自己掉了](https://buildx.do/t/%E7%99%BB%E5%BD%95%E8%BF%87%E4%B8%80%E4%BC%9A%E5%84%BF%E8%87%AA%E5%B7%B1%E6%8E%89%E4%BA%86/125)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 15:18 UTC](https://buildx.do/t/%E7%99%BB%E5%BD%95%E8%BF%87%E4%B8%80%E4%BC%9A%E5%84%BF%E8%87%AA%E5%B7%B1%E6%8E%89%E4%BA%86/125 "2026-10-05T15:18:00Z")

</div>

「登录过一会儿自己掉了」。 不是关页面。大概一个小时。和会话时长有关吗？我想对一下大家的设置。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 提问时写四样：你做了什么，期望什么，实际什么，已经排除了什么。日志贴关键的一段，不要整文件。能缩小范围的对比写出来，例如只有空库失败、只有一台机器失败、只有大文件…

---

## [外接盘会掉](https://buildx.do/t/%E5%A4%96%E6%8E%A5%E7%9B%98%E4%BC%9A%E6%8E%89/165)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 11:48 UTC](https://buildx.do/t/%E5%A4%96%E6%8E%A5%E7%9B%98%E4%BC%9A%E6%8E%89/165 "2026-10-06T11:48:00Z")

</div>

「外接盘会掉」。 口上的供电不稳。换到机箱后面的口，稳定了。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电不稳，优先看，再重…

---

## [小版本修了一个泄漏](https://buildx.do/t/%E5%B0%8F%E7%89%88%E6%9C%AC%E4%BF%AE%E4%BA%86%E4%B8%80%E4%B8%AA%E6%B3%84%E6%BC%8F/148)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 03:34 UTC](https://buildx.do/t/%E5%B0%8F%E7%89%88%E6%9C%AC%E4%BF%AE%E4%BA%86%E4%B8%80%E4%B8%AA%E6%B3%84%E6%BC%8F/148 "2026-10-06T03:34:00Z")

</div>

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

---

## [日志重启就没了](https://buildx.do/t/%E6%97%A5%E5%BF%97%E9%87%8D%E5%90%AF%E5%B0%B1%E6%B2%A1%E4%BA%86/29)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 13:46 UTC](https://buildx.do/t/%E6%97%A5%E5%BF%97%E9%87%8D%E5%90%AF%E5%B0%B1%E6%B2%A1%E4%BA%86/29 "2026-10-03T13:46:00Z")

</div>

故障发生时容器已经重启过，里面的日志文件跟着没了。只记得‘刚才报过错’，没有原文。 原因是日志写在容器可写层里。容器一换，层就丢。我们改成把日志打到标准输出，由外面的收集把标准输出存下来。 也试过挂一个目录到容器里。能留住文件，但要自己处理切割和权限。标准输出这条路更少维护。 每条日志带上时间、级别和请求编号。没有编号的话，一次请求的几行会对不到一起。 重启之后再故意触发一次错误，确认收集端能看到。只改配置、不验证，会在下一次故…

---

## [小图不必另找地方放](https://buildx.do/t/%E5%B0%8F%E5%9B%BE%E4%B8%8D%E5%BF%85%E5%8F%A6%E6%89%BE%E5%9C%B0%E6%96%B9%E6%94%BE/244)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 8 日 05:06 UTC](https://buildx.do/t/%E5%B0%8F%E5%9B%BE%E4%B8%8D%E5%BF%85%E5%8F%A6%E6%89%BE%E5%9C%B0%E6%96%B9%E6%94%BE/244 "2026-10-08T05:06: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/%E6%89%B9%E9%87%8F%E6%94%B9%E5%90%8D/112)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 08:22 UTC](https://buildx.do/t/%E6%89%B9%E9%87%8F%E6%94%B9%E5%90%8D/112 "2026-10-05T08:22:00Z")

</div>

「批量改名」。 先列出将要改的，确认再执行。我吃过一次改宽了的亏。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执行。 这次按时间写…

---

## [命名和实际做的事对不上](https://buildx.do/t/%E5%91%BD%E5%90%8D%E5%92%8C%E5%AE%9E%E9%99%85%E5%81%9A%E7%9A%84%E4%BA%8B%E5%AF%B9%E4%B8%8D%E4%B8%8A/37)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 18:02 UTC](https://buildx.do/t/%E5%91%BD%E5%90%8D%E5%92%8C%E5%AE%9E%E9%99%85%E5%81%9A%E7%9A%84%E4%BA%8B%E5%AF%B9%E4%B8%8D%E4%B8%8A/37 "2026-10-03T18:02:00Z")

</div>

函数名叫保存，读的人会以为它只写库。里面还发了通知、写了一条审计。调用方漏看了副作用，在不该通知的路径上也调了它。 我没有立刻大改名字，先在调用处加了说明，并把发通知做成参数，默认保持原样，避免一次性改出更多行为变化。 新的调用点使用明确的名字：只保存，或保存并通知。旧名字标成不推荐，注释写明替代的两个函数。 测试分成两条。一条断言没有通知，一条断言通知发出去了。以前只有一条，看不出副作用。 评审时我们多看了一眼名字和函数体的第…

---

## [只有窄屏会错位](https://buildx.do/t/%E5%8F%AA%E6%9C%89%E7%AA%84%E5%B1%8F%E4%BC%9A%E9%94%99%E4%BD%8D/121)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 13:10 UTC](https://buildx.do/t/%E5%8F%AA%E6%9C%89%E7%AA%84%E5%B1%8F%E4%BC%9A%E9%94%99%E4%BD%8D/121 "2026-10-05T13:10:00Z")

</div>

「只有窄屏会错位」。 宽屏正常。我怀疑是某层宽度没限制。想请看过类似问题的人指个方向。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 提问时写四样：你做了什么，期望什么，实际什么，已经排除了什么。日志贴关键的一段，不要整文件。能缩小范围的对比写出来，例如只有空库失败、只…

---

## [共同设计不是先做完再请人试用](https://buildx.do/t/%E5%85%B1%E5%90%8C%E8%AE%BE%E8%AE%A1%E4%B8%8D%E6%98%AF%E5%85%88%E5%81%9A%E5%AE%8C%E5%86%8D%E8%AF%B7%E4%BA%BA%E8%AF%95%E7%94%A8/258)

<div class="topic-metadata">

**Author:** [@maolin](https://buildx.do/u/maolin)\
**回复:** 3\
**最近更新：:** [2026 年10 月 8 日 22:45 UTC](https://buildx.do/t/%E5%85%B1%E5%90%8C%E8%AE%BE%E8%AE%A1%E4%B8%8D%E6%98%AF%E5%85%88%E5%81%9A%E5%AE%8C%E5%86%8D%E8%AF%B7%E4%BA%BA%E8%AF%95%E7%94%A8/258 "2026-10-08T22:45:00Z")

</div>

一些面向残障者的工具，失败在于做完才请人试。试用者只能说好不好看，来不及改流程。公开的公益赛题里反复出现一个要求：把使用者当成共同设计的人，而不是验收时才出现的观众。出行、购物、支付、就医这些场景，没有当事人参与，需求会写成我们想象的困难。 小团队可以学这个顺序。先找一位真实使用者，问他上一次没有完成的是哪一步，而不是问他想要什么功能。把那一步写成我们的第一篇帖子：现在怎么失败，怎样算完成。然后再写代码或文档。 没有条件找到使用者时，至少不要用自己的熟练操作代替别人。把鼠标拔掉走一遍，把窗口缩到很窄走一遍，把图片的替代文字念出来听一遍。这三遍不是完整的共同设计，但能去掉最自负的那部分。 B…

---

## [多返回了一个内部字段](https://buildx.do/t/%E5%A4%9A%E8%BF%94%E5%9B%9E%E4%BA%86%E4%B8%80%E4%B8%AA%E5%86%85%E9%83%A8%E5%AD%97%E6%AE%B5/40)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 3 日 19:38 UTC](https://buildx.do/t/%E5%A4%9A%E8%BF%94%E5%9B%9E%E4%BA%86%E4%B8%80%E4%B8%AA%E5%86%85%E9%83%A8%E5%AD%97%E6%AE%B5/40 "2026-10-03T19:38:00Z")

</div>

调用方只需要名称和状态。响应里多了一个内部编号，是给后台任务用的，不该出现在对外结果里。 内部编号一旦被外面依赖，以后就删不掉。我在被依赖之前把它从响应里拿掉了。 加了一条测试，断言响应字段只有约定的那几个。多一个字段，测试就失败。 内部任务仍用编号，但走内部方法，不从这条对外响应里读。两边分开之后，改对外字段不会弄坏任务。 说明里补了响应示例。示例和测试用同一组字段，避免文档又把内部编号写回去。 发布后看了真实响应，内部编号…

---

## [电源不够](https://buildx.do/t/%E7%94%B5%E6%BA%90%E4%B8%8D%E5%A4%9F/159)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 08:36 UTC](https://buildx.do/t/%E7%94%B5%E6%BA%90%E4%B8%8D%E5%A4%9F/159 "2026-10-06T08:36:00Z")

</div>

「电源不够」。 一编译就重启。不是系统坏了。换了功率足够的电源。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进仓库的就进仓库，换机器还能用。过热和供电不稳，优先看，…

---

## [风扇太响](https://buildx.do/t/%E9%A3%8E%E6%89%87%E5%A4%AA%E5%93%8D/156)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 07:00 UTC](https://buildx.do/t/%E9%A3%8E%E6%89%87%E5%A4%AA%E5%93%8D/156 "2026-10-06T07:00:00Z")

</div>

「风扇太响」。 降一点频率，声音能接受，时间多几分钟。我选择安静。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 先分清是程序的问题还是这台机器的问题。线、电源、温度、风道都会伪装成软件故障。改硬件时记下型号和改了什么，配置文件能进…

---

## [自我介绍可以短](https://buildx.do/t/%E8%87%AA%E6%88%91%E4%BB%8B%E7%BB%8D%E5%8F%AF%E4%BB%A5%E7%9F%AD/168)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 13:24 UTC](https://buildx.do/t/%E8%87%AA%E6%88%91%E4%BB%8B%E7%BB%8D%E5%8F%AF%E4%BB%A5%E7%9F%AD/168 "2026-10-06T13:24:00Z")

</div>

「自我介绍可以短」。 你在写什么，最近卡在哪。两句就够，别写成简历。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 活动只为一件具体的事，时间写短。读代码就读一个真实函数，分享就讲一个问题。自我介绍两句就够：在写什么，卡在哪。结束后…

---

## [备份放在找得到的地方](https://buildx.do/t/%E5%A4%87%E4%BB%BD%E6%94%BE%E5%9C%A8%E6%89%BE%E5%BE%97%E5%88%B0%E7%9A%84%E5%9C%B0%E6%96%B9/118)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 11:34 UTC](https://buildx.do/t/%E5%A4%87%E4%BB%BD%E6%94%BE%E5%9C%A8%E6%89%BE%E5%BE%97%E5%88%B0%E7%9A%84%E5%9C%B0%E6%96%B9/118 "2026-10-05T11:34:00Z")

</div>

「备份放在找得到的地方」。 脚本旁边写一句何时跑、失败看哪里。人走了也还能用。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 工具够用就行，不比谁的套件全。选的时候看它能不能把一件重复的事变短，以及结果能不能放进仓库让别人也用。本地和测试的地址、账号分开存。批量操作先列出将要改的名单，确认后再执行。 这…

---

## [文档站换了地址](https://buildx.do/t/%E6%96%87%E6%A1%A3%E7%AB%99%E6%8D%A2%E4%BA%86%E5%9C%B0%E5%9D%80/149)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 6 日 04:06 UTC](https://buildx.do/t/%E6%96%87%E6%A1%A3%E7%AB%99%E6%8D%A2%E4%BA%86%E5%9C%B0%E5%9D%80/149 "2026-10-06T04:06:00Z")

</div>

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

---

## [后台任务别和用户请求抢同一组资源](https://buildx.do/t/%E5%90%8E%E5%8F%B0%E4%BB%BB%E5%8A%A1%E5%88%AB%E5%92%8C%E7%94%A8%E6%88%B7%E8%AF%B7%E6%B1%82%E6%8A%A2%E5%90%8C%E4%B8%80%E7%BB%84%E8%B5%84%E6%BA%90/200)

<div class="topic-metadata">

**Author:** [@caiwen](https://buildx.do/u/caiwen)\
**回复:** 1\
**最近更新：:** [2026 年10 月 7 日 05:38 UTC](https://buildx.do/t/%E5%90%8E%E5%8F%B0%E4%BB%BB%E5%8A%A1%E5%88%AB%E5%92%8C%E7%94%A8%E6%88%B7%E8%AF%B7%E6%B1%82%E6%8A%A2%E5%90%8C%E4%B8%80%E7%BB%84%E8%B5%84%E6%BA%90/200 "2026-10-07T05:38:00Z")

</div>

「后台任务别和用户请求抢同一组资源」。 任务一忙，页面就慢。分开之后，页面稳了。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 先写不做什么。多一个组件就多一种故障，量不大就不要先加队列或缓存。每一层的等待时间写明，重试要有次数和间隔的上限。同一状态只在一个地方改。请求编号从入口带下去，不然日…

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

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