Doxygen 1.8.14生成的HTML页面在Chrome中无法通过哈希锚点滚动定位

我之前也碰到过Doxygen旧版本生成的文档在Chrome里锚点失效的情况，结合你的场景，给你几个可行的解决方案：

• 升级Doxygen到最新稳定版
  Doxygen 1.8.14是2017年的旧版本，后续迭代修复了大量浏览器兼容性问题，尤其是针对Chrome这类持续更新的现代浏览器。直接升级到1.9.x系列的最新稳定版（比如1.9.8），重新生成文档，大概率能彻底解决锚点不滚动的问题。

• 检查锚点元素的ID属性
  旧版Doxygen有时会用name属性而非id属性定义锚点，而Chrome现在对锚点解析更严格，优先识别id。你可以打开生成的PageA.html，查看对应主题的标题标签（比如<h1>/<h2>）是否带有id="tag_topic1"这类属性：

  • 如果只有name属性，少量页面可以手动给标题元素补充id；
  • 大量页面的话，修改Doxygen配置文件（Doxyfile），确保开启生成id锚点的相关选项，保证输出的锚点使用标准的id属性。

• 排查JavaScript干扰问题
  旧版Doxygen生成的HTML会包含自定义JS，可能和Chrome的滚动逻辑冲突。你可以临时在Doxyfile里设置GENERATE_JAVASCRIPT = NO，重新生成文档后测试锚点——如果恢复正常，说明是JS的问题。后续要么升级Doxygen（新版本JS兼容性更好），要么手动修改生成的JS文件，移除影响滚动的代码片段。

• 临时规避：添加URL参数
  如果你暂时没法升级Doxygen，可以给锚点链接加个无关的URL参数，比如把[topic 1](PageA.html#tag_topic1)改成[topic 1](PageA.html#tag_topic1?chrome-fix)。这个小技巧能强制Chrome重新计算页面滚动位置，避免缓存或JS逻辑导致的滚动失效。

• 清空Chrome缓存或使用无痕模式
  有时候Chrome缓存了旧的HTML/JS文件，导致新生成的文档没生效。试试用Ctrl+Shift+Del清空浏览器缓存，或者用无痕窗口打开文档，排除缓存的影响。

内容的提问来源于stack exchange，提问作者Hongkun Wang