标题先回答一个具体问题#

写标题时尽量避免只写“学习笔记”“问题记录”这种泛词。更好的写法是把技术点、动作和结果放进去，例如“pandas 读取 CSV 编码问题”比“pandas 笔记”更容易检索。

• 技术对象：pandas、Nginx、YOLO、OpenCV。

• 具体动作：读取、排查、迁移、构建、导出。

• 结果边界：编码问题、404/403、小样本训练、缓存未更新。

摘要要补足标题没有说完的信息#

摘要不需要重复标题，而是说明文章解决什么场景。比如标题已经写了“SSH 连接超时排查”，摘要就应该补充“从网络端口、安全组、sshd 服务和客户端参数四个层面定位”。

一个可用的摘要通常包含三块：遇到什么现象、检查哪些位置、读完能得到什么操作结论。

发布前检查清单#

• 标题里是否有明确对象，而不是只有“记录”“总结”。

• 摘要是否能独立说明文章价值，而不是把正文第一句复制一遍。

• 标题和分类是否一致，避免算法文章放到问题解决里。

• 搜索关键词是否自然出现，例如 Pagefind、frontmatter、rolling、YOLO。

• 列表页展示时是否会被截断后失去关键信息。

我会避免的写法#

最容易偷懒的写法是“某某问题整理笔记”，但读者无法从标题判断这是入门教程、排错记录，还是完整实践流程。以后回头找文章时，这种标题也最浪费时间。

实战复盘#

把《博客标题与摘要检查清单》真正用起来，我会在发布后回到站点里看三个位置：文章页、分类页和搜索结果。文章页看正文是否完整，分类页看它是否进入正确栏目，搜索结果看标题和摘要是否能被关键词命中。

如果这篇文章后续被修改，我会保留原始发布时间，只改正文和摘要。这样归档时间不会被频繁扰动，读者也能看出这篇内容是在哪个阶段整理出来的。

这类博客维护文章的验收标准不是“能不能发布”，而是以后遇到同类问题时，能不能按文章里的检查清单快速完成一次操作。

最小验收样例#

验收《博客标题与摘要检查清单》时，我会选一篇真实文章或一个真实页面作为样例，而不是只看源码。先确认页面能打开，再确认列表、分类、归档、搜索这些入口都能找到它。

如果文章讲的是站点维护，还要记录修改前后差异：改了哪个文件、构建产物是否更新、线上 HTTP 状态码是多少。这样后面出问题时，可以直接回到这次验收记录。

小结#

标题和摘要的质量，本质上是在替未来的自己做索引。写清楚对象、动作和结果，文章才不会只在发布当天有用。