ctrl+alt+k 无反应是因快捷键被系统或插件冲突拦截,需手动配置 json 快捷键绑定并确保 when 条件为 editortextfocus。

Bookmarks 插件安装后为什么 ctrl+alt+k 没反应?
默认快捷键在部分系统(尤其是 Windows 中文输入法下)会被拦截,或与其它插件冲突。不是插件没装好,而是快捷键没生效。
实操建议:
- 打开命令面板(
ctrl+shift+p),输入Preferences: Open Keyboard Shortcuts (JSON),直接编辑快捷键配置 - 添加自定义绑定,例如:
[{"key": "ctrl+alt+b","command": "bookmarks.toggle","when": "editorTextFocus"},{"key": "ctrl+alt+up","command": "bookmarks.jumpToNext","when": "editorTextFocus"},{"key": "ctrl+alt+down","command": "bookmarks.jumpToPrevious","when": "editorTextFocus"}] - 确认
when条件为editorTextFocus,否则光标不在编辑器时无法触发
如何批量跳转并区分不同类型的书签?
Bookmarks 插件本身不支持「分类标签」,但可通过命名约定 + bookmarks.list 命令实现逻辑分组。
实操建议:
- 添加书签时,在备注里加前缀,比如
[API]、[TODO]、[TEST]—— 这些会显示在书签列表中 - 按
ctrl+shift+p输入Bookmarks: List,回车后可看到所有带备注的书签,支持模糊搜索(如输API就只列相关项) - 注意:书签位置是文件内绝对行号,如果代码大幅重排,书签仍保留原位置,可能指向已失效的空行或注释
多人协作时书签会同步吗?
不会。Bookmarks 插件的书签数据默认存在 VSCode 的本地工作区缓存(.vscode/bookmarks.json 不是标准生成路径),且不纳入 Git 跟踪。
实操建议:
- 若需共享定位点,改用
// TODO:或// BOOKMARK:注释,配合 VSCode 内置的References: Find All References或Search: Find in Files(搜BOOKMARK) - 想持久化书签?可手动导出:执行
Bookmarks: Export生成 JSON 文件,但导入需手动触发,不能自动随项目加载 - 别把书签当文档用——它本质是个人导航辅助,不是协作标记机制
为什么跳转后光标总在行首,没法快速编辑?
因为 bookmarks.jumpToNext 默认行为是「移动光标」而非「选中内容」,和 Ctrl+Click 跳转函数的行为逻辑不同。
实操建议:
- 添加书签时,把光标停在关键符号上(如函数名、变量名左侧),再按快捷键打书签,这样跳转后能立刻
f2重命名或ctrl+shift+left选中标识符 - 如果常需跳转+编辑,可绑定一个组合命令(需借助
multi-command插件):先bookmarks.jumpToNext,再editor.action.addSelectionToNextFindMatch - 注意:书签本身不记录选区范围,只记行号+列号,列号精度依赖你打书签时的光标位置











