bookmarks插件未响应需重装并重新加载窗口；命名书签（ctrl+alt+shift+k）基于内容匹配，支持跨文件跳转；持久化需配置"bookmarks.persisted": true。
Bookmarks插件没反应？先确认命令是否注册成功
按 Ctrl+Alt+K（Windows/Linux）或 Cmd+Option+K（macOS）没反应，大概率不是快捷键冲突，而是插件根本没加载。打开命令面板 Ctrl+Shift+P，输入 Bookmarks: Toggle —— 如果列表里不出现这条命令，说明插件未启用。必须重装作者为 alefragnani 的 Bookmarks 插件，并点击“重新加载窗口”（不是关再开），否则命令绑定不会生效。
普通书签 vs 命名书签：行号绑定 vs 内容容错
默认用 Ctrl+Alt+K 打的书签只绑定行号，一旦上面增删代码，书签就偏移了。真正适合标记“核心代码块”的是命名书签：Ctrl+Alt+Shift+K（Windows/Linux）或 Cmd+Option+Shift+K（macOS），输入如 init-state 或 auth-check。之后通过 Bookmarks: Jump to Bookmark 命令跳转，它会基于当前文件内容匹配最接近的位置，而不是死守行号。
- 命名书签不显示在
Bookmarks: List All简略列表里，得单独调用跳转命令 - 右键命名书签可重命名或删除；普通书签只能删不能改名
- 命名书签跨文件有效，但目标文件必须在当前工作区范围内
书签重启就消失？持久化配置漏写了
默认情况下，VSCode 关闭后所有书签都会丢——这不是 bug，是设计如此。要保留，必须在工作区的 settings.json 中显式开启：
"bookmarks.persisted": true
注意不是 bookmarks.persistAll（那是旧版或误传配置）。开启后，书签存到 .vscode/bookmarks.json 里，换窗口、重启、甚至关机都不丢。如果用了 Settings Sync，这个设置也得同步过去，否则别人拉你配置还是不持久。
跨文件跳转总失败？别依赖 Ctrl+Alt+J/L
Ctrl+Alt+J 和 Ctrl+Alt+L 只按添加时间顺序在已打开文件内跳，且不保证跨文件。真要跨文件精准定位，必须用全局命令：Ctrl+Shift+P → 输入 Bookmarks: List All → 回车。列表支持模糊搜索（比如输 render 就过滤含该词的书签行），选中后 VSCode 会自动打开未打开的文件并定位到行。
多根工作区下，书签默认隔离在各自根目录内，跨根跳转需手动切换工作区再查；列表为空时，优先检查是否开了 "bookmarks.persisted": true。
// #region 折叠注释做视觉锚点辅助定位。
