长文目录功能测试

2026年10月4日文章约 3 分钟阅读

这是一篇用于验收「文章目录」功能的测试文章（frontmatter 里开启了 toc: true）。下面每个小节都对应目录中的一项，方便逐条对照检查；未开启该选项的文章（站内其余文章）不会出现任何目录元素。

桌面端的左侧目录栏

在窗口宽度不小于 1280px 的桌面上，正文左侧的留白区应该出现一条吸顶目录。目录只收录二级与三级标题，更深的层级不出现；条目过多时目录自身可以滚动，且始终吸附在视口左侧，不随正文滚走。

正文列本身应保持原来的宽度与居中位置——目录占用的是正文之外的留白区，不应该把正文挤窄或推向一侧。页面拉到最右时也不应出现横向滚动条，窗口从 1280px 缓慢变宽的过程中，目录应始终贴在正文左缘外侧。

滚动或点击进入任意小节后，目录中对应条目应呈现当前态：左侧出现品牌绿竖条、文字提亮、字重加重。快速滚动经过多个小节时，高亮应逐节跟随，不应跳档、滞留或闪烁。用读屏检查时，当前条目应能被播报为「当前位置」。

窗口窄于 1280px 时，左侧目录栏整体隐藏，取而代之的是文章标题下方一个「目录」折叠面板。面板默认展开，是页面内容流的一部分，随正文一起滚动；不需要时可以点击标题行收起，收起后不遮挡正文。展开时的条目与桌面版完全一致，同样带当前态高亮。

点击面板内任意条目，页面应跳到对应小节；随后收起面板，阅读位置保持在跳转后的位置，不应弹回顶部或发生二次跳动。

点击目录条目后，目标标题应停在视口靠上的位置并留出呼吸位：桌面上方约一行字的高度；移动端因为顶栏吸顶，标题应停在顶栏下沿，而不是被顶栏盖住。地址栏会带上对应小节的锚点，把这个链接直接发给别人，对方打开后也应正确定位到该小节。

若系统开启了「减少动态效果」（或浏览器设置里勾选了相应偏好），点击目录的跳转应变为瞬时完成，不再有滚动动画；锚点落位与当前态高亮不受影响。

浅色与深色两套主题下目录都应清晰可读：当前态使用品牌绿，其余条目为低饱和的次要文字色。目录字号明显小于正文，属于工具性导航，不与正文争夺注意力；切换主题或调整正文 Aa 字号偏好的过程中，目录样式应保持稳定，不参与缩放。

这是一篇临时验收文章（inArticleList: false，不进入上一篇/下一篇序列），检查确认后删掉这个 Markdown 文件即可。若想留作目录功能的说明页也可以保留，不影响其他内容。

目录功能对未开启 toc: true 的文章完全无感——可以随便打开一篇旧长文对照检查，页面结构与之前保持一致。