# 这篇是发布前的检查单

**URL:** <https://buildx.do/t/%E8%BF%99%E7%AF%87%E6%98%AF%E5%8F%91%E5%B8%83%E5%89%8D%E7%9A%84%E6%A3%80%E6%9F%A5%E5%8D%95/184>\
**Category:** 笔记共建\
**Tags:** 原创翻译\
**Created:** [2026 年10 月 6 日 20:42 UTC](https://buildx.do/t/%E8%BF%99%E7%AF%87%E6%98%AF%E5%8F%91%E5%B8%83%E5%89%8D%E7%9A%84%E6%A3%80%E6%9F%A5%E5%8D%95/184 "2026-10-06T20:42:00Z")\
**Posts on this page:** 2\
**Page:** 1

<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 月 6 日 20:42 UTC](https://buildx.do/t/%E8%BF%99%E7%AF%87%E6%98%AF%E5%8F%91%E5%B8%83%E5%89%8D%E7%9A%84%E6%A3%80%E6%9F%A5%E5%8D%95/184/1 "2026-10-06T20:42:00Z")

</div>

「这篇是发布前的检查单」。

不长。适合贴在自己的清单旁边对照。

记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。

译完要让人能照着做，不是只换一种语言。术语对照放在文末，正文保持可读。例子如果换成我们在用的语言，步骤必须还能试。我的理解写在引用外面，不把猜测写成作者的话。原文后来改了，就把差异补在末尾，不悄悄改正文。

这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。

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

补充记录。翻译的标准是别人能照着做。术语对照放文末，正文不堆原文。例子若改成我们在用的语言，每一步都要还能试，试不通就标明卡在哪。只对当地读者有用的背景可以不译，做法不能丢。我的理解写在引用外面。原文后来有更新，把差异补在末尾，不悄悄改正文，这样早先的讨论还对得上。已经有官方中文的不重复译。没有把握的词保留原文在括号里，让别人直接改。

操作顺序。1. 先确认没有官方中文，有就不重复译。2. 术语对照列在文末，正文保持能读完。3. 例子改成我们的语言后，逐步试一遍，试不通就写明卡在哪一步。4. 只对当地读者有用的背景可以不译，做法不能省。5. 自己的理解放在引用之外。6. 原文若更新，把差异补在末尾，不改已经讨论过的正文。7. 没有把握的词在括号里留原文。别人能直接改词，而且照着步骤能做完，这篇翻译才算完成。

---

<div class="post-metadata">

**Author:** ![suyanran](https://buildx.do/letter_avatar_proxy/v4/letter/s/b2d939/32.png) [@suyanran](https://buildx.do/u/suyanran)\
**Post date:** [2026 年10 月 6 日 21:56 UTC](https://buildx.do/t/%E8%BF%99%E7%AF%87%E6%98%AF%E5%8F%91%E5%B8%83%E5%89%8D%E7%9A%84%E6%A3%80%E6%9F%A5%E5%8D%95/184/2 "2026-10-06T21:56:00Z")

</div>

检查单可以贴在自己的发布清单旁边，逐项对照，不必一次背完。
