vscode书签需装alefragnani.bookmarks插件，90%问题源于装错作者、未开持久化或快捷键被系统拦截；验证方法：cmd+shift+p执行bookmarks: toggle、右键行号看选项、检查editor.glyphmargin为true；跨文件跳转唯一可靠方式是bookmarks: list all。
VSCode 本身不带书签功能，必须装 alefragnani.bookmarks 插件才能用；装错作者、没开持久化、快捷键被系统拦截，这三类问题占了 90% 的“书签没反应”报障。
怎么确认 Bookmarks 插件真正在工作
别急着按 Cmd+Option+K，先验证插件是否加载成功：
- 按下
Cmd+Shift+P打开命令面板，输入Bookmarks: Toggle—— 如果列表里压根不出现，说明插件没启用，重装作者为Alessandro Fragnani的版本（ID 必须是alefragnani.bookmarks） - 安装后点“重新加载窗口”，否则快捷键绑定不会注册
- 右键行号区域，看上下文菜单里有没有
Toggle Bookmark选项；有，说明底层 API 已就绪 - 如果
Bookmarks: Toggle能执行但没图标，检查设置里是否禁用了装饰器："editor.glyphMargin": true必须开启
Ctrl+Alt+K 按了没反应？大概率不是插件问题
Windows/Linux 上 Ctrl+Alt+K 极易被劫持，macOS 上 Cmd+Option+K 也常被输入法或系统快捷键吞掉：
- 临时切换为英文输入法再试；笔记本用户加按
Fn键可能绕过硬件拦截 - 打开
keybindings.json，搜bookmarks.toggle，确认该条目存在且没有when条件限制（比如editorTextFocus && !editorReadonly是合理条件，false就是废的） - 在命令面板里手动执行一次
Bookmarks: Toggle，能成功就说明功能完好，只需修快捷键
跨文件跳转必须用 List All，别信 Ctrl+Alt+J
Ctrl+Alt+J / Cmd+Option+J 只在当前打开的文件内跳“最近添加的书签”，它不跨文件、不查全局、也不支持搜索 —— 这是最大认知偏差：
- 跨文件导航唯一可靠方式是
Cmd+Shift+P→ 输入Bookmarks: List All→ 回车 - 列表中每条显示为
文件名:行号 — 代码片段，支持实时模糊过滤（输render就只留含 render 的行） - 选中后回车，VSCode 会自动打开未打开的文件并定位到行；但如果路径含空格、中文未编码、或符号链接断裂，该条目会静默消失
- 命名书签（
Cmd+Option+Shift+K）不会出现在List All里，得用Bookmarks: Jump to Bookmark单独调用
书签重启就丢？三个配置点必须检查
默认情况下书签只存内存，关窗口即清空。要真正持久，得手动干预：
- 在工作区根目录的
.vscode/settings.json里加一行："bookmarks.persistAll": true（注意不是用户设置，多根工作区下每个根都要单独配） - 启用后数据落地为
.vscode/bookmarks.json，可被 Git 跟踪，协作时也能共享结构 - 删了带书签的整行 = 书签消失，因为它是绑定“行”而非“逻辑”；命名书签容错性高些，但依然依赖文件内容匹配，行号大改后也可能偏移
- 导出备份用
Bookmarks: Export，导入用Bookmarks: Import，JSON 格式纯文本，无兼容风险
最常被忽略的是：命名书签和普通书签走的是两套存储与索引机制，List All 看不到命名书签，Jump to Bookmark 也找不到普通书签——它们不是同一类东西，混用会卡死在“我以为它该在这儿”的状态里。
