如何建立博客，导入内容后标题与文件错位如何核对对应关系
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /a5c3f3d40c1a.html
📄
如何建立博客，导入内容后标题与文件错位如何核对对应关系
错位通常不是导入失败，而是标题字段与文件名的匹配规则被重写了。先确认导入器用的是文件名、front matter 还是数据库里的标题字段，再决定是回滚重导还是逐条修正；两者没有绝对优劣，取决于错位是批量规律性的还是零散随机的。
先判断错位属于哪一种：规律性偏移还是随机错配
把导入后的文章列表按标题排序，再按文件名排序，对比两个序列。如果错位呈固定位移，比如每篇标题都对应到下一篇的文件，说明导入时读取的是上一行的缓存或索引错了一位，属于规律性偏移。如果错位没有规律，A 的标题跑到 C 的文件上，B 的标题跑到 F 的文件上，多半是标题字段与文件名的映射表在合并阶段被覆盖，属于随机错配。
两种情况的处理路径不同。规律性偏移可以整体回滚后重新导入，成本低；随机错配必须逐条核对，因为重新导入可能再次触发同样的覆盖顺序。
核对对应关系时先建立一份可追溯的映射清单
不要直接在后台改标题，那样会丢掉原始对应关系。先在本地或数据库导出一份清单，至少包含四列：文件路径、文件名（不含扩展名）、导入后显示的标题、原始内容里第一个 h1 或 front matter 的 title 值。
把这份清单按文件名排序，逐行比对第三列和第四列。两者一致的行标记为正常，不一致的行标记为待核对。这一步的动作结果是：你能得到错位的准确数量和分布，而不是凭印象判断“好像都乱了”。如果待核对行数占总行数的比例很高，说明问题出在导入规则而非个别数据，应优先检查导入器配置。
两种条件下的不同选择：回滚重导还是原地修正
条件一：错位行数少且文件内容本身完整。此时原地修正更快。打开待核对文件，用文件内第一个 h1 或 front matter 的 title 作为真实标题，覆盖导入后显示的标题。每修正一条就从清单里划掉一条，直到清单清空。这个动作的结果是标题与文件重新绑定，且不需要动其他字段。
条件二：错位行数多且呈规律性偏移。此时原地修正容易改错——你可能在修正 A 的时候把 B 的标题也带偏。更稳妥的做法是先备份当前数据库或导出全部文章，然后清空这批导入内容，调整导入器的匹配字段（改为按文件名匹配或按 front matter 的 title 匹配），再重新导入一次。重新导入后立刻抽查前十条和后十条的对应关系，确认偏移是否消失。
例外情况：如果导入器不支持指定匹配字段，或者重新导入会覆盖已有的分类、标签、发布时间，那么即使错位行数多，也应选择原地修正，避免引入新的数据损失。
用一个短例子说明核对方法
假设你导入了 20 篇文章，文件名是 post-01.md 到 post-20.md，每篇文件内的 title 依次是“入门”“进阶”“实战”等。导入后你发现 post-01.md 显示的是“进阶”，post-02.md 显示的是“实战”，依次后移一位。这是典型的规律性偏移。此时回滚重导并指定按文件名匹配，比逐条改 20 个标题更可靠。这个例子是假设的，用来演示判断顺序，不代表任何具体工具的默认行为。
核对完成后还要确认哪些信号才算真正解决
标题与文件对应正确，不等于导入流程已经稳定。你需要再检查三件事：第一，打开任意一篇错位修正后的文章，确认正文内容与标题描述的是同一主题；第二，检查文章的固定链接或 slug 是否也跟着标题变了，如果变了，之前分享出去的链接可能失效；第三，如果站点有站内搜索或归档页，确认这些入口展示的标题也同步更新，而不是只改了编辑页。
只有这三项都一致，才能认为对应关系已经修复。如果只改了编辑页标题而前台仍显示旧标题，说明还有缓存或另一份标题副本没有被覆盖，需要回到映射清单继续排查。
