必须安装alefragnani.bookmarks插件，其他同名插件不支持命名书签、跨文件List All及导出备份；安装后需通过Ctrl+Shift+P执行Bookmarks: List验证是否生效，作者须为alefragnani且更新日期在2026年内。
书签插件必须装 alefragnani 版本，否则跨文件跳转失效
VSCode 市场里叫 “Bookmarks” 的插件不止一个，但只有 alefragnani.bookmarks 支持命名、跨文件列表、导出备份等核心能力。其他同名插件（比如 Code Bookmarks 或 Bookmarks Lite）压根没有 Bookmarks: List from All Files 命令，也做不到按标签跳转。
安装后检查是否生效：按 Ctrl+Shift+P 输入 Bookmarks: List，能弹出列表即说明插件已加载；若没反应，先确认扩展面板里作者名确实是 alefragnani，且最后更新日期在 2026 年内。
常见误装场景：
- 搜索 “bookmarks” 时点了第一个但作者是 “vscode-bookmarks-team” —— 这个不维护了，功能残缺
- 用旧版 VSCode（
- 工作区配置里写了
"bookmarks.enabled": false，插件被手动禁用
Ctrl+Alt+K 没反应？先查这三件事
快捷键失效不是插件坏了，而是环境没就绪。最常踩的坑是：
-
Ctrl+Alt+K只对文本文件有效 —— 在 Settings UI、Output 面板、终端里按它，必然没反应 - 快捷键被其他插件覆盖 —— 进
Preferences: Open Keyboard Shortcuts (JSON)，搜bookmarks.toggle，确认绑定没被改成别的命令 - 当前文件类型没被识别为可编辑文本 —— 检查右下角语言模式是不是
Plain Text或JavaScript等；如果是Unknown，手动点击切换成对应语言
顺带一提：Ctrl+Alt+L（添加标签书签）和 Ctrl+Alt+Shift+K（命名书签）也遵循同样规则，别在非代码文件里试。
阅读进度要持久化，必须改配置项
默认情况下，重启 VSCode 后所有书签全丢 —— 这不是 bug，是设计如此。想让书签跨会话保留，得手动加配置：
- 全局生效：在用户设置里加
"bookmarks.saveBookmarksInProject": true - 项目级生效：在项目根目录的
.vscode/settings.json里写同一行 - 如果还想要导出备份，启用
"bookmarks.exportOnSave": true，书签会自动存成.vscode/bookmarks.json
注意："bookmarks.saveBookmarksBetweenSessions": true 是旧版参数，2026 年起已被弃用，设了也没用。
用命名书签替代 TODO 注释，才真正管用
单纯标记 // TODO: 行意义不大，因为没法分类、筛选、跳转。真正有效的做法是把 TODO 当成书签名来用：
- 光标停在
// TODO: 重构 auth 流程这一行，按Ctrl+Alt+Shift+K - 输入名字，比如
auth-refactor（别带空格，方便命令行匹配） - 之后用
Ctrl+Shift+P→Bookmarks: Jump to Bookmark，直接输auth就能命中
这个机制比全局搜索靠谱得多：它只匹配你亲手打过标签的位置，不会把注释里偶然出现的单词也拉进来。而且命名书签天然支持跨文件 —— 不用纠结“现在在哪打开的文件”，只要名字对，秒跳。
容易忽略的一点：命名书签不会显示在侧边栏图标里，只出现在 List from All Files 和 Jump to Bookmark 的候选列表中。别以为没加成功，其实是藏起来了。
