vscode需安装alefragnani的bookmarks插件才能使用书签功能;安装后重启加载,用ctrl+alt+k(win/linux)或cmd+option+k(macos)添加/取消书签,跳转用ctrl+alt+down/up按添加顺序循环,持久化需在settings.json中设置"bookmarks.persisted": true。

VSCode 默认不带书签功能,必须装 Bookmarks 插件才能用——装完就能标记、跳转、跨文件管理,不依赖项目配置,也不需要改任何代码。
怎么安装并确认插件生效
插件没装或没启用,所有快捷键和命令都会报错或直接不响应。别跳过这步。
- 点左侧扩展图标(四个方块),搜
Bookmarks,认准作者是alefragnani的那个 - 点“安装”,完成后点击“重新加载”按钮(不是关窗口再开,是点这个按钮)
- 重载后,随便打开一个文件,把光标放一行上,按
Ctrl+Alt+K(Win/Linux)或Cmd+Option+K(macOS),看行号旁有没有出现蓝色/紫色小点 - 没反应?打开命令面板(
Ctrl+Shift+P),输Bookmarks: Add Bookmark,能执行说明插件已就位
添加和取消书签的几种方式
最常用的是快捷键,但右键菜单和命令面板也得知道——尤其当快捷键被其他插件占用时。
-
Ctrl+Alt+K(Win/Linux)或Cmd+Option+K(macOS):在当前行添加/取消书签 - 右键点击行号区域 → 选
Toggle Bookmark:适合鼠标操作场景,比如调试时快速切 - 命令面板输入
Bookmarks: Add Bookmark:100% 可靠,不受快捷键冲突影响 - 注意:书签只标记「行」,不记录列位置;同一行反复按快捷键只是开关,不会重复创建
在多个书签间跳转的实际行为
跳转不是随机的,而是严格按「添加时间顺序」线性遍历,这点容易误解。
-
Ctrl+Alt+J(Win/Linux)或Cmd+Option+J(macOS):跳到「最近添加」的那个书签(不是下一个) -
Ctrl+Alt+Down/Ctrl+Alt+Up:这才是按添加顺序正向/反向循环跳转,更符合日常浏览逻辑 - 如果跳转失效,先检查是否误用了
J和Down—— 它们是两套不同逻辑,J是“回溯最后标记点”,Down是“顺着列表往下走” - 跨文件跳转完全没问题,但默认不自动打开未打开的文件标签页(会静默打开并跳转)
书签存哪儿了?关 VSCode 后还在吗
默认是会丢的——这是最常被忽略的坑。你辛苦标了 20 个书签,重启后全没了,不是插件坏了,是没开持久化。
- 打开
settings.json(Ctrl+,→ 右上角齿轮 → “打开设置(JSON)”) - 加这一行:
"bookmarks.persisted": true - 保存后,书签就会存在工作区目录下的
.vscode/bookmarks.json里,关机、重启、换窗口都不丢 - 如果用 Settings Sync,记得把这个设置也同步过去,否则别人拉你配置可能还是不持久
真正麻烦的不是怎么加书签,而是以为它“应该一直都在”却没开 persisted;还有人卡在跳转逻辑上,死磕 J 键想实现顺序跳转,其实该用 Down。











