内容完整性#

先对照旧文章确认标题、正文、代码块和图片是否完整。特别是代码块，迁移时很容易因为反引号缺失导致后半篇文章格式全乱。

如果旧文章只有代码，新博客里最好补上题目背景、输入输出、思路和复杂度，不要原样塞进来。

元数据重建#

旧博客可能没有 description、tags 或 category。迁移时要重新补齐，而不是全部用默认值。

创建时间原则上保留旧文章时间，除非文章已经被完全重写并且需要作为新内容发布。

链接和图片#

• 文章内链是否还指向旧域名。

• 图片路径是否能在新站访问。

• 旧 URL 是否需要跳转到新 URL。

• 分类页和归档页是否出现这篇文章。

搜索验证#

迁移后至少用标题中的两个关键词搜一次。能打开页面不代表能被搜索到，搜索索引必须在新构建产物里重新生成。

实战复盘#

我会用《旧文章迁移质量检查》建立一个可复用的维护标准：先说明为什么要做，再写具体检查项，最后给出发布后的确认方式。读者照着做时，不需要再猜下一步。

博客类文章最容易变成泛泛而谈，所以每篇都应该留下明确对象，例如 frontmatter、Pagefind、Nginx、Sitemap、分类卡片。对象越明确，文章越容易被搜索和复用。

如果以后发现文章只有原则没有操作，就应该补一个最小命令或检查清单。维护博客本身也是工程工作，要能验证、能回滚、能复盘。

最小验收样例#

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

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

小结#

迁移文章的重点是恢复文章的使用价值，而不是只恢复文件数量。读者能顺利阅读和检索，迁移才算完成。