vscode 默认无书签功能,需安装插件bookmarks(alefragnani);启用后快捷键为ctrl+alt+k(增删)、ctrl+alt+j/l(上下跳转);需开启bookmarks: persisted以持久化保存至.bookmarks.json。

VSCode 里书签功能默认不可用,得先装插件
VSCode 原生不带书签(Bookmark)功能,直接按 Ctrl+Alt+K 或类似组合键会没反应。必须装第三方插件,最稳定常用的是 Bookmarks(作者:alefragnani)。别选错成同名但更新停滞的旧版本。
安装后重启 VSCode(部分版本需手动启用),插件图标会出现在侧边栏底部,点击可展开书签列表。
- 插件安装后默认启用快捷键,无需额外配置;若失效,检查是否被其他插件或键盘布局冲突(比如输入法切换导致
Ctrl+Alt被拦截) - Mac 用户注意:快捷键中的
Ctrl对应系统里的Cmd,实际是Cmd+Alt+K - 插件支持多光标书签,但一次只能在一个光标位置打上书签;多个光标同时触发会只在第一个生效
打书签和跳转的快捷键组合要记牢
核心操作就三个快捷键,建议固定使用,避免混用鼠标点击——效率差一截:
-
Ctrl+Alt+K:在当前行首插入/删除书签(不是光标位置,是整行标记) -
Ctrl+Alt+J:跳转到下一个书签(按添加顺序循环) -
Ctrl+Alt+L:跳转到上一个书签
注意:Ctrl+Alt+J/L 是「跳转」,不是「选中」;跳过去后光标停在行首,不会自动选中代码。如果想快速定位再编辑,建议跳转后立刻按 Home 或 End 调整光标。
书签不保存?那是没开持久化开关
默认情况下,Bookmarks 插件关闭后书签就丢了。要跨会话保留,必须手动开启工作区级持久化:
- 打开设置(
Ctrl+,),搜bookmarks,找到Bookmarks: Persisted,勾选它 - 该设置写入当前工作区的
.vscode/settings.json,而非全局设置,避免污染其他项目 - 开启后书签数据存在
.vscode/bookmarks.json,别把这个文件加进.gitignore—— 否则团队成员看不到你打的书签
如果多人协作,建议把 bookmarks.json 提交到仓库,但注意:它记录的是绝对行号,代码大幅重构后跳转会偏移,属于正常现象。
跳转时卡顿或跳错行?检查折叠与空行干扰
书签跳转逻辑基于行号,但 VSCode 的代码折叠、空行、注释块会影响视觉定位:
- 已折叠的代码块内打了书签,跳转后仍处于折叠状态,看起来像“跳空了”——手动展开即可
- 连续多空行时,书签打在第 2 个空行,跳转后光标停在那,容易误判为失败;建议打书签前确保目标行有内容或至少非纯空白
- 跳转快捷键在终端或调试控制台焦点下无效,必须确保编辑器窗口有焦点(点一下代码区域再按)
复杂文件里书签超过 50 个时,侧边栏书签列表滚动会略慢,但不影响快捷键跳转性能——真正卡顿往往来自插件本身启用了「高亮当前书签行」且开启了动画,可在插件设置里关掉 Bookmarks: Highlight Line。











