bookmarks插件需安装alefragnani官方版本（700万+安装量、2026年更新），支持命名书签、跨文件list all及导出备份；ctrl+alt+k失效需检查文件类型、快捷键冲突及工作区启用状态；默认书签不持久，须配置"bookmarks.savebookmarksinproject": true或手动导出json。
Bookmarks 插件不是“可选技巧”，而是源码阅读时的刚需导航工具——没它，你得靠 Ctrl+F 滚屏 20 分钟找 init 函数；有它，3 秒跳到 5 个关键入口点。
怎么确认自己装的是正确版本的 Bookmarks
VSCode 市场里叫 “Bookmarks” 的插件有多个，但只有 alefragnani.bookmarks（作者 Alessandro Fragnani）支持命名书签、跨文件列表、导出备份等核心功能。其他同名插件要么功能残缺，要么已停止维护。
- 打开扩展面板（
Ctrl+Shift+X），搜索Bookmarks - 认准作者名是
alefragnani，安装量超 700 万，最后更新日期在 2026 年内 - 装完后，左侧活动栏应自动出现旗帜图标；若没有，按
Ctrl+Shift+P输入Bookmarks: List，能执行即说明生效 - 别信“Code Bookmarks”或“Bookmarks Lite”——它们不支持
Bookmarks: Jump to Bookmark这类语义化跳转命令
Ctrl+Alt+K 没反应？检查这三处硬性依赖
快捷键失效不是插件坏了，而是 VSCode 层面的冲突或状态未就绪：
- 当前编辑器必须处于“文本文件”模式（如
.js、.py、.go），在 Settings UI 或 Output 面板里按Ctrl+Alt+K无效是正常行为 - 确保没被其他插件劫持：进
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON)，搜索bookmarks.toggle，确认绑定未被覆盖 - 工作区禁用了插件：右键项目文件夹 →
Configure Workspace Settings→ 检查"extensions.ignoreRecommendations"是否为true，或是"bookmarks.enabled"被设为false
为什么跳转总卡在上一个文件？用对命令才能跨文件导航
Ctrl+Alt+J / Ctrl+Alt+L 默认只在“当前文件”内跳转，这不是 bug，是设计逻辑——它模拟的是“阅读上下文流”，而非全局索引。真要跨文件定位，必须换命令：
- 查看全部书签：
Ctrl+Shift+P→ 输入Bookmarks: List All（不是List，少All就只显示当前文件） - 按文件筛选：面板弹出后直接打字，比如输入
router，会过滤出所有含router的代码行预览 - 命名书签才是跨文件主力：
Ctrl+Alt+Shift+K添加时输入auth-init，之后用Bookmarks: Jump to Bookmark直接选名字，不依赖顺序 - 注意：命名书签默认不显示在侧边栏书签图标里，只出现在
List All和命令面板中
重启 VSCode 后书签全没了？默认不持久是最大坑点
插件默认把书签存在内存里，关窗口就丢——这对源码阅读极其危险，尤其当你花半小时标好 12 个关键路径后。
- 启用项目级持久化：在工作区设置（
.vscode/settings.json）里加一行："bookmarks.saveBookmarksInProject": true - 这样书签会写入
.vscode/bookmarks.json，可提交 Git，团队共享标记习惯 - 如果不想进 Git，改用
Bookmarks: Export手动导出 JSON，再通过Bookmarks: Import恢复——但注意导入是“追加”，不是覆盖 - 别依赖全局设置同步：Settings Sync 只同步配置，不同步书签数据，除非你额外配置了
bookmarks.export.path
真正难的不是记住快捷键，而是判断什么时候该用命名书签、什么时候该导出、什么时候必须开 saveBookmarksInProject。源码里那些分散在 7 个文件里的初始化钩子，靠 Ctrl+Alt+L 是串不起来的——得靠名字、靠文件路径、靠手动存档。
