VSCode无内置离线章节收藏功能，需组合使用大纲视图、Bookmarks插件（如alefragnani版）打书签及手动添加Markdown锚点实现；书签依赖行号易偏移，锚点链接更稳定但需手动维护ID。
VSCode 本身不提供“离线文档收藏章节”功能，尤其对 Markdown 或纯文本类文档——它没有内置的章节书签、锚点持久化或跨重启高亮机制。所谓“收藏重要章节”，实际要靠组合手段实现：大纲视图定位 + Bookmarks 插件打点 + 手动锚点维护。
为什么不能直接用大纲视图“收藏”章节
VSCode 的大纲（Outline）只是实时解析 #、## 等标题生成的导航树，它不保存状态，也不支持标记“这是我要反复看的第三节”。关掉文件再打开，大纲依然存在，但你上次停在哪一节？它不会记住。
- 大纲点击跳转后，光标位置不会被持久化，也无法批量跳回多个重点章节
- 大纲条目本身不能右键“添加收藏”，也没有“星标”“置顶”等交互
- 如果文档用的是非标准标题（比如用
**加粗文字**模拟章节），大纲直接不显示该条目
Bookmarks 插件是目前最可行的“章节收藏”方案
在 Markdown 文档里，把光标停在某个章节标题行（如 ### 数据预处理步骤），按 Ctrl+Alt+K 打上书签，就相当于给这一节“钉了个桩”。之后无论切换多少文件、重启 VSCode（需开启持久化），都能用 Ctrl+Alt+J/Ctrl+Alt+L 跳转。
- 确保已安装官方认可的 Bookmarks 扩展（作者
alefragnani），不是Bookmark（单数）或Code Bookmarks - 检查设置
bookmarks.showGutterIcon为true，否则左侧边距不显示图标，容易漏掉已打点的行 - Markdown 默认在
bookmarks.languages白名单中，但若你用.txt或自定义后缀，需手动加到设置："bookmarks.languages": ["markdown", "plaintext"] - 书签依赖行号，如果章节标题前后增删了空行或内容，书签会偏移——这不是 bug，是设计使然，得接受“轻量即易漂移”
想让“收藏”更稳？加个手动锚点+跳转命令
如果某几个章节你几乎每天都要访问，仅靠书签还不够直观。可以在文档开头建一个“导航区”，用标准 Markdown 链接指向各章节锚点：
[→ 第二章：模型结构](#模型结构)<br>[→ 第四章：训练调参](#训练调参)
然后在对应章节标题下手动加上 <a id="模型结构"></a>（或用 ## 模型结构 {#模型结构}，需启用 markdown.extension.anchors.enabled）。这样点击链接就能跳转，且不依赖插件、不随行号漂移。
- 这种锚点方式完全离线生效，导出 HTML 也保留跳转
- 缺点是得自己维护 ID 命名，不能自动同步书签列表
- 和 Bookmarks 插件不冲突，可并存：书签用于临时多点跳转，锚点链接用于固定高频入口
真正容易被忽略的是：VSCode 不会帮你判断“哪一节更重要”，它只响应你明确落下的光标和按键。收藏章节这件事，本质上是你在和编辑器共建一套轻量导航契约——你负责打点，它负责记住；你负责写锚点，它负责跳转。没有全自动，但每一步都可控。
