VSCode 原生无书签功能，需安装 alefragnani.bookmarks 插件；90%“没反应”源于装错作者、快捷键冲突或未开启持久化；跨文件跳转唯一可靠方式是 Bookmarks: List All，支持模糊搜索；书签默认不持久，需在工作区 settings.json 中设 "bookmarks.persistAll": true。
VSCode 原生不支持书签功能，必须安装 alefragnani.bookmarks 插件才能用；装错作者、快捷键被系统拦截、没开持久化，这三类问题占了 90% 的“没反应”报障。
Ctrl+Alt+K 按了没图标？先确认插件真在工作
别急着重装，先验证底层是否就绪：
- 按
Ctrl+Shift+P输入Bookmarks: Toggle—— 如果命令不出现，说明插件没启用，重装作者为Alessandro Fragnani的版本（ID 必须是alefragnani.bookmarks） - 右键行号区域，看上下文菜单里有没有
Toggle Bookmark选项；有，说明编辑器 API 已注册 - 检查设置里
"editor.glyphMargin"是否为true，否则 gutter 图标根本不会渲染 - 默认只对
javascript、python、typescript等语言显示图标；若在json或markdown文件里看不到，但跳转正常，那是预期行为
跨文件跳转只能靠 Bookmarks: List All
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）都如此 - 临时解法：跳转后立刻按
End或Ctrl+Right移动到行尾，再手动回退 - 更稳的做法是——在关键函数定义行添加书签时，把光标停在函数名上再按
Ctrl+Alt+K，这样跳转后至少离编辑起点近一点
