# 选之前看最后一次提交

**URL:** <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>\
**Category:** 开源藏珍\
**Tags:** 开源项目\
**Created:** [2026 年10 月 4 日 10:19 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-04T10:19:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![maolin](https://buildx.do/letter_avatar_proxy/v4/letter/m/dfb087/32.png) [@maolin](https://buildx.do/u/maolin)\
**Post date:** [2026 年10 月 4 日 10:19 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/1 "2026-10-04T10:19:00Z")

</div>

「选之前看最后一次提交」。

文档还在，仓库已经半年没动。能用，但出了问题不一定有人接。我改选了一个还在更新的。

收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。

用进项目之前看三件事：最后一次提交、协议、讨论区里是不是反复同一个坑。只为了一个小功能引进一整套，通常不划算。大版本先读迁移说明，在分支上试。锁文件要提交。给上游提修改时按他们的格式来。选它的理由写下来，几个月后会忘记。

给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。

复查「选之前看最后一次提交」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。引进之前写三行：最后一次提交是什么时候，协议允不允许我们这样用，讨论区是不是反复同一个安装坑。三行有任何一行过不了，就先不要引进。只为了一个小功能而背上整套概念，后面会在升级和安全更新上还债。大版本单独开分支，按迁移说明试，默认值可能和以前相反。锁文件和代码一起提交，保证别人装到同一版。给上游提修改时先读他们的贡献说明，格式和测试按他们的来。选它而不选另一个的理由写在仓库里，几个月后没人记得。

操作顺序。1. 看最后一次提交日期和未关闭的讨论。2. 读协议，确认我们的用法在范围内。3. 只取需要的功能，关掉其余默认项。4. 大版本先在分支按迁移说明试，不直接升。5. 锁文件和代码一起提交，并用干净目录安装一次。6. 要改上游就先读贡献说明，按他们的测试和格式提交。7. 在仓库写三行：为什么选它、什么时候再评估、谁负责升级。没有这三行，半年后没人敢动它，也没人敢换掉它。

---

<div class="post-metadata">

**Author:** ![linxiao](https://buildx.do/letter_avatar_proxy/v4/letter/l/d78d45/32.png) [@linxiao](https://buildx.do/u/linxiao)\
**Post date:** [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/2 "2026-10-04T11:20:00Z")

</div>

仓库半年没提交，文档还在，也不等于能用。我现在先看最后一次提交日期。
