文章里有三个「常见问题」小标题,自动生成的目录点了第二、第三条,页面还是滚到第一个,地址栏里的 # 一模一样;审查元素看,三个 h2 的 id 都是 changjianwenti。碰到这种情况,我一般先确认改动有没有真的生效。

原因不复杂,目录脚本按标题文字转拼音或 slug 生成 id,没有做重名递增,中文标题转出来本来就容易撞。浏览器遇到重复 id 只认第一个,锚点自然全落到同一处。

「目录 id 重复」这类改动最怕改一半,回滚脚本先准备好,再动生产。日志级别临时调高可以,记得改回去,长期开着既占磁盘又掩盖真问题。

const seen = {};
function uid(base) {
  seen[base] = (seen[base] || 0) + 1;
  return seen[base] === 1 ? base : base + '-' + seen[base];
}

具体做法是,在生成 id 的函数里加一个计数表,同一个 slug 第二次出现就补上 -2、-3 后缀;已经写死在正文里的 id 不要动,只对自动生成的标题去重,避免历史链接失效;重新生成目录后,把目录项的 href 和标题 id 对一遍,确认一一对应。

最后用这个标准收尾,点目录里的第二、第三个「常见问题」,页面分别滚到对应位置,地址栏的 # 后缀不再相同。

作者 9823189