# \#开源项目

**URL:** https://buildx.do/tag/open-source/5.md

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

---

## [文档漂亮，讨论区全是同一个坑](https://buildx.do/t/%E6%96%87%E6%A1%A3%E6%BC%82%E4%BA%AE%EF%BC%8C%E8%AE%A8%E8%AE%BA%E5%8C%BA%E5%85%A8%E6%98%AF%E5%90%8C%E4%B8%80%E4%B8%AA%E5%9D%91/73)

<div class="topic-metadata">

**Author:** [@fenglan](https://buildx.do/u/fenglan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 12:24 UTC](https://buildx.do/t/%E6%96%87%E6%A1%A3%E6%BC%82%E4%BA%AE%EF%BC%8C%E8%AE%A8%E8%AE%BA%E5%8C%BA%E5%85%A8%E6%98%AF%E5%90%8C%E4%B8%80%E4%B8%AA%E5%9D%91/73 "2026-10-04T12:24:00Z")

</div>

「文档漂亮，讨论区全是同一个坑」。 安装步骤过时了。讨论区第一条就有解法。以讨论区为准，并给文档提了一句。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本…

---

## [关掉用不到的功能](https://buildx.do/t/%E5%85%B3%E6%8E%89%E7%94%A8%E4%B8%8D%E5%88%B0%E7%9A%84%E5%8A%9F%E8%83%BD/79)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 15:36 UTC](https://buildx.do/t/%E5%85%B3%E6%8E%89%E7%94%A8%E4%B8%8D%E5%88%B0%E7%9A%84%E5%8A%9F%E8%83%BD/79 "2026-10-04T15:36:00Z")

</div>

「关掉用不到的功能」。 默认开太多。配置里关掉，启动快一点，表面也小一点。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件…

---

## [给上游提了很小的修复](https://buildx.do/t/%E7%BB%99%E4%B8%8A%E6%B8%B8%E6%8F%90%E4%BA%86%E5%BE%88%E5%B0%8F%E7%9A%84%E4%BF%AE%E5%A4%8D/76)

<div class="topic-metadata">

**Author:** [@linxiao](https://buildx.do/u/linxiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 14:00 UTC](https://buildx.do/t/%E7%BB%99%E4%B8%8A%E6%B8%B8%E6%8F%90%E4%BA%86%E5%BE%88%E5%B0%8F%E7%9A%84%E4%BF%AE%E5%A4%8D/76 "2026-10-04T14:00:00Z")

</div>

「给上游提了很小的修复」。 错别字加一条失败时的提示。按他们的格式改了提交说明。被人合并的感觉很好。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。…

---

## [感谢里写上用到的项目](https://buildx.do/t/%E6%84%9F%E8%B0%A2%E9%87%8C%E5%86%99%E4%B8%8A%E7%94%A8%E5%88%B0%E7%9A%84%E9%A1%B9%E7%9B%AE/82)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 17:12 UTC](https://buildx.do/t/%E6%84%9F%E8%B0%A2%E9%87%8C%E5%86%99%E4%B8%8A%E7%94%A8%E5%88%B0%E7%9A%84%E9%A1%B9%E7%9B%AE/82 "2026-10-04T17:12:00Z")

</div>

「感谢里写上用到的项目」。 不是客套。以后自己也找得到当时为什么选它。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。给上游提修改时按他们的格式来。…

---

## [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/%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%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/%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/%E7%89%88%E6%9C%AC%E9%94%81%E4%BD%8F/80)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 16:08 UTC](https://buildx.do/t/%E7%89%88%E6%9C%AC%E9%94%81%E4%BD%8F/80 "2026-10-04T16:08:00Z")

</div>

「版本锁住」。 昨天好的，今天拉下来就炸。锁文件提交之后，大家才一致。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。给上游提修改时按他们…

---

## [大版本先读迁移说明](https://buildx.do/t/%E5%A4%A7%E7%89%88%E6%9C%AC%E5%85%88%E8%AF%BB%E8%BF%81%E7%A7%BB%E8%AF%B4%E6%98%8E/75)

<div class="topic-metadata">

**Author:** [@shenrui](https://buildx.do/u/shenrui)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 13:28 UTC](https://buildx.do/t/%E5%A4%A7%E7%89%88%E6%9C%AC%E5%85%88%E8%AF%BB%E8%BF%81%E7%A7%BB%E8%AF%B4%E6%98%8E/75 "2026-10-04T13:28:00Z")

</div>

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

---

## [先看协议](https://buildx.do/t/%E5%85%88%E7%9C%8B%E5%8D%8F%E8%AE%AE/72)

<div class="topic-metadata">

**Author:** [@dengyi](https://buildx.do/u/dengyi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 4 日 11:52 UTC](https://buildx.do/t/%E5%85%88%E7%9C%8B%E5%8D%8F%E8%AE%AE/72 "2026-10-04T11:52: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/%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/%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>

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