Ctrl+Alt+K没反应需先验证插件加载：检查Bookmarks: Toggle命令是否存在、右键行号有无Toggle Bookmark选项、editor.glyphMargin设为true，并重载窗口；快捷键功能与常见误解需区分清楚。
Ctrl+Alt+K 按了没反应？先确认插件真在工作
90% 的“没图标、没跳转”问题，不是快捷键冲突，而是 alefragnani.bookmarks 插件根本没加载成功。别急着重装，先验证三件事：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Bookmarks: Toggle—— 如果命令不出现，说明插件未启用；重装作者必须是alefragnani，ID 必须是alefragnani.bookmarks - 右键点击行号区域，看上下文菜单里有没有
Toggle Bookmark选项；有，说明编辑器装饰器 API 已注册 - 检查设置：
"editor.glyphMargin"必须为true，否则书签图标根本不渲染（即使书签已存在）
装完插件后务必点“重新加载窗口”，不是关掉再开——这是命令绑定生效的必要步骤。
Ctrl+Alt+J 和 Ctrl+Alt+L 不跨文件，也非顺序跳转
很多人以为 Ctrl+Alt+J 是“上一个书签”，Ctrl+Alt+L 是“下一个”，结果跳来跳去只在当前文件打转，甚至反复回到同一行。真相是：
-
Ctrl+Alt+J（Win/Linux）或Cmd+Option+J（macOS）：跳到「最近一次添加的书签」，不管它在哪个文件、是否已打开 -
Ctrl+Alt+Down/Ctrl+Alt+Up：才按「添加时间顺序」正向/反向循环，这才是日常浏览该用的导航方式 - 两者都不支持模糊搜索，也不管你当前在哪——它们只认全局书签池里的时间戳
想跨文件、可筛选、带代码预览的跳转？唯一可靠入口是 Bookmarks: List All（Ctrl+Shift+P → 输入执行），列表显示为 file.ts:42 — const data = ...，输关键词实时过滤。
书签重启就丢？bookmarks.persistAll 必须写进工作区设置
默认书签只存内存，关 VSCode 就清空。持久化不是开关，是配置项，且极易配错：
- 必须在工作区根目录的
.vscode/settings.json里加："bookmarks.persistAll": true -
"bookmarks.persisted": true是旧版配置，2026 年起已废弃，设了也无效 - 多根工作区下，每个根目录都要单独配
.vscode/settings.json；漏配一个，那个根下的书签就永远不持久 - 命名书签（
Ctrl+Alt+Shift+K）同样依赖这个配置，否则名字存不住
注意：即使开了持久化，删了带书签的整行，书签依然消失——它绑定的是物理行号，不是逻辑位置。
命名书签怎么用？容错高但调用路径不同
普通书签靠行号，一动代码就偏移；命名书签靠内容匹配，更适合标记函数入口、错误处理块等关键逻辑点：
- 打命名书签：
Ctrl+Alt+Shift+K（Win/Linux）或Cmd+Option+Shift+K（macOS）→ 输入如init-state或auth-fail-handler→ 回车 - 调用命名书签：不能用
Bookmarks: List All，必须走Bookmarks: Jump to Bookmark（Ctrl+Shift+P输入） - 命名书签不参与行号排序，也不会因插入/删除代码而错位，但它不会自动跨文件搜索——只在当前打开的文件里做内容匹配
真正容易被忽略的是：所有跳转命令（包括命名书签跳转）都会把光标放在行首，不保留原列位置；这不是 bug，是设计，也没法改。
