技术文章如何自检：标题、代码和验证结论必须说同一件事

技术文章如何自检：标题、代码和验证结论必须说同一件事

一篇技术文章最明显的问题，不一定是错别字，而是标题讲写作，代码却突然变成无关的重试引擎。发布前先检查主题链路是否一致。

三次阅读

第一遍只看标题和小标题，确认问题逐步收敛；第二遍核对每段事实是否有来源；第三遍运行代码或至少检查 API、错误路径和依赖。没有原始记录的性能表直接删掉。

检查代码是否服务论点

代码示例先回答三个问题：它调用的 API 是否与标题相关，失败路径是否解释清楚，参数是否有可追溯来源。缺少其中一项，就应补齐验证或移除示例。以重试器为例，至少要交代业务错误如何分类、操作是否幂等、超时和退避由谁配置；这些信息不完整时，不能把它描述成“自愈”。

技术写作的可信度来自主题、代码与验证三者互相支持。删掉不相关内容，通常比补一段宏大总结更有效。