vscode无内置书签功能，跨文件跳转必须依赖alefragnani.bookmarks插件；确认其工作需执行bookmarks: toggle命令、检查右键菜单有toggle bookmark选项，并确保"editor.glyphmargin": true；跨文件唯一可靠方式是bookmarks: list all；书签默认不持久，须在工作区settings.json中配置"bookmarks.persistall": true；命名书签（ctrl+alt+shift+k）比行号书签更抗代码变动。
VSCode 本身没有内置书签功能，跨文件跳转必须依赖 alefragnani.bookmarks 插件，且默认快捷键（如 Ctrl+Alt+J）根本不管跨文件的事——它只在当前文件里打转。
怎么确认 Bookmarks 插件真正在工作
90% 的“按了没反应”问题，其实插件压根没加载成功。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Bookmarks: Toggle—— 如果命令不出现，说明插件未启用；重装作者为alefragnani的版本（ID 必须是alefragnani.bookmarks），安装后点“重新加载窗口” - 右键行号区域，看上下文菜单里有没有
Toggle Bookmark；有，说明底层装饰器 API 已就绪 - 检查设置：
"editor.glyphMargin": true必须为true，否则书签图标不会显示在装订区
跨文件跳转唯一可靠方式是 Bookmarks: List All
Ctrl+Alt+J / Cmd+Option+J 不跨文件，也不支持搜索，它只跳“最近添加的那一个”，而且仅限当前打开的文件。
- 真正跨文件导航：用
Ctrl+Shift+P→ 输入Bookmarks: List All→ 回车 - 列表格式为
文件名:行号 — 代码片段，支持实时模糊过滤（输render就只留含render的行） - 选中后回车，VSCode 会自动打开未打开的文件并定位到行；但如果路径含空格、中文未编码、或符号链接断裂，该条目会静默消失
- 命名书签（
Ctrl+Alt+Shift+K）不会出现在这个列表里，得用Bookmarks: Jump to Bookmark单独调用
为什么重启后书签全没了
默认书签只存内存，关窗口即清空。持久化不是开个开关就行，而是要手动配进工作区设置。
- 在工作区根目录的
.vscode/settings.json里加一行："bookmarks.persistAll": true（注意不是用户级设置） - 多根工作区下，每个根目录都要单独配；漏配一个，那个文件夹下的书签就永远不持久
-
"bookmarks.persisted": true是旧版配置项，2026 年起已废弃，设了也无效 - 删了带书签的整行，书签就跟着消失——它绑定的是“行”，不是“逻辑”，这点容易误判
命名书签比行号书签更抗修改
直接按 Ctrl+Alt+K 打的书签只认行号，一旦上面插入/删除代码，位置立刻错位。
- 改用命名书签：
Ctrl+Alt+Shift+K（Win/Linux）或Cmd+Option+Shift+K（macOS）→ 输入如init-state或error-handler→ 回车 - 之后通过
Ctrl+Shift+P→Bookmarks: Jump to Bookmark选择名称跳转，它会基于当前文件内容匹配最接近的位置，容错性高得多 - 命名书签不参与
List All排序，也不受行号变动影响，但无法跨文件自动重映射——它只在当前文件内做语义匹配
真正容易被忽略的是：书签是否跨根生效、是否绑定到了正确的配置层级、以及命名书签和行号书签根本不在同一套索引体系里——混用时定位行为完全不同。
