# 一个不依赖服务的小库

**URL:** <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>\
**Category:** 筑码工坊\
**Tags:** 作品展示\
**Created:** [2026 年10 月 5 日 22:29 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-05T22:29:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![xujing](https://buildx.do/letter_avatar_proxy/v4/letter/x/2bfe46/32.png) [@xujing](https://buildx.do/u/xujing)\
**Post date:** [2026 年10 月 5 日 22:29 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/1 "2026-10-05T22:29:00Z")

</div>

「一个不依赖服务的小库」。

放进项目就能用。没有账号，没有联网。适合内部小脚本。

判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。

展示的是一个能用的小东西，不是计划。写清楚它解决哪一件具体的事，输入是什么，输出是什么，什么情况下不要用。边界没做完就直说。主路径通了就可以给别人试，不必等所有边角都齐。

先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。

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

补充记录。展示写给会用的人，不写给围观的人。第一段说明它解决的一件事。第二段写输入和输出，最好有一条最小例子。第三段写不要在什么情况下用，例如数据太大、需要外网、还没做的边界。主路径通了就可以给别人试，边角列在后面，不要等全部做完。错误提示写下一件事，而不只写代号。仓库里放怎么跑、怎么停。停不掉的小工具，不该算做完。

操作顺序。1. 用一段话说明它解决的一件事。2. 给出最小输入和对应输出。3. 写明不要在什么情况下用。4. 写怎么启动、怎么停、失败时看哪。5. 主路径通了就让别人试，没做的边界列在后面。6. 错误提示写成下一件事，而不是只给代号。7. 自己按说明从干净环境走一遍。走不通就改说明。展示的标准不是功能多，而是另一个人能在不问作者的情况下用起来并停掉。

---

<div class="post-metadata">

**Author:** ![caiwen](https://buildx.do/letter_avatar_proxy/v4/letter/c/bc79bd/32.png) [@caiwen](https://buildx.do/u/caiwen)\
**Post date:** [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/2 "2026-10-05T23:50:00Z")

</div>

不联网的小库适合放进内部脚本。没有账号，也就少一种故障。
