必须安装 alefragnani.bookmarks 插件，验证启用成功需三步：命令面板输入 Bookmarks: Toggle 确认命令存在、右键行号区查看 Toggle Bookmark 菜单项、检查 editor.glyphMargin 为 true。
必须装 alefragnani.bookmarks，其他同名插件基本无效；装完不生效，90% 是快捷键冲突或未开 glyph margin。
怎么确认插件真装对了
VSCode 原生没书签功能，所有“Ctrl+Alt+K 没反应”的问题，第一步不是重装，是验证是否启用成功：
- 按
Ctrl+Shift+P输入Bookmarks: Toggle—— 如果命令不出现，说明插件根本没启用，重装时务必认准作者 Alessandro Fragnani、ID 必须是alefragnani.bookmarks - 右键编辑器左侧行号区域（gutter），看上下文菜单里有没有
Toggle Bookmark—— 有，说明插件已注册到编辑器 API - 检查设置：
"editor.glyphMargin"必须为true，否则 gutter 图标压根不渲染，你根本看不到书签图标 - 默认只在
javascript、python、typescript等语言模式下显示图标；在json或markdown文件里看不到图标但跳转正常，属于预期行为
为什么 Ctrl+Alt+K 按了没反应
不是插件坏了，是快捷键被系统或其它插件劫持了。Windows 中文输入法、某些安全软件、甚至 WSL 集成插件都可能拦截 Ctrl+Alt+K。
- 打开命令面板
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON) - 在
keybindings.json里加一条明确绑定，例如：[{"key":"ctrl+alt+b","command":"bookmarks.toggle","when":"editorTextFocus"}] - 关键点：
"when":"editorTextFocus"必须写上，否则光标不在编辑器时命令不会触发 - 避免用
Ctrl+Alt+K本身——它和 Windows 系统级快捷键（如语言切换）高度重合，换一个更干净的组合，比如Ctrl+Alt+B或Ctrl+Shift+K
跨文件跳转只能靠 List All，别信 Ctrl+Alt+J/L
Ctrl+Alt+J 和 Ctrl+Alt+L 只在当前打开的文件内跳，不查全局、不跨文件、也不支持搜索——这是最常被误解的一点。
- 真正跨文件导航的唯一可靠方式是：
Ctrl+Shift+P→ 输入Bookmarks: List All→ 回车 - 列表中每条显示为
文件名:行号 — 代码片段，支持实时模糊过滤（输render就只留含render的行） - 选中后回车，VSCode 会自动打开未打开的文件并定位到行；但如果路径含空格、中文未编码、或符号链接断裂，该条目会静默消失（不报错、不提示）
- 命名书签（
Cmd+Option+Shift+K）不会出现在List All里，得单独调用Bookmarks: Jump to Bookmark
书签重启就丢？三个配置点必须手动设
默认书签只存在内存里，关窗口即清空。要真正持久，必须改工作区设置，不是用户级设置。
- 在工作区根目录的
.vscode/settings.json里加："bookmarks.persistAll": true - 多根工作区下，每个根目录都要单独配；否则只保存第一个根的书签
- 若想让书签随项目共享（比如团队共用关键入口），别依赖插件数据——改用
// BOOKMARK:注释 +Search: Find in Files，因为插件书签默认不进 Git - 导出用
Bookmarks: Export，但导入需手动触发Bookmarks: Import，不能自动加载
跳转后光标总在行首，不是 bug 是设计：所有跳转命令（bookmarks.jumpToNext、bookmarks.jumpToPrevious、bookmarks.list）都如此，且截至 2026 年 8 月没有内置参数可改——这点容易被忽略，但影响实际编码节奏。
