安装bookmarks插件后，需执行“bookmarks: list from all files”命令（快捷键ctrl+alt+p/cmd+opt+p）打开全局书签侧栏；命名书签（ctrl+alt+shift+k）是侧栏可用前提，支持前缀归类与模糊搜索，但不支持手动分组或侧栏内编辑。
VSCode 本身没有内置书签侧栏，必须装 Bookmarks 插件才能启用带名称、可跨文件管理的书签列表功能——不装插件，所有快捷键和命令都无效。
安装 Bookmarks 插件后如何打开书签侧栏
插件默认不自动显示侧栏，需手动触发：Bookmarks: List from All Files 是唯一能唤出全局书签面板的命令，它以侧栏形式展开，不是弹窗或浮层。
- 快捷键：Windows/Linux 用
Ctrl+Alt+P，macOS 用Cmd+Opt+P - 命令面板输入：
Bookmarks: List from All Files（注意不是List Bookmarks，后者只列当前文件） - 该面板会按文件路径分组，每条目含行号、代码预览片段、文件名（跨文件时显示相对路径）
- 面板一旦打开，会常驻侧边栏，关闭需点击右上角 × 或按
Escape
命名书签是让侧栏真正可用的前提
未命名的书签在侧栏里只显示为 Bookmark #1、#2 这类序号，大型项目中根本无法区分。命名不是可选项，而是使用侧栏的基本前提。
- 光标停在目标行，按
Ctrl+Alt+Shift+K（Win/Linux）或Cmd+Opt+Shift+K（macOS）输入名称，例如auth-init、TODO-db-migration - 名称支持空格和连字符，但避免特殊符号（如
/、:），否则可能影响模糊搜索匹配 - 命名后，侧栏中对应条目立刻显示该名称，悬停还能看到完整代码行预览
- 右键侧栏中的书签条目可直接
Rename Bookmark，无需回到源码行
侧栏里的书签不能手动分组，但可通过命名模拟逻辑归类
VSCode Bookmarks 插件不支持拖拽分组、创建文件夹或打标签分类。所谓“分组归类”只能靠命名约定 + 模糊搜索实现。
- 在名称前加统一前缀，例如：
api-/login、ui-header-render、test-setup-jest - 在侧栏中按
Ctrl+F（Win/Linux）或Cmd+F（macOS）输入前缀，即可过滤出同一类书签 - 不要依赖书签顺序——插件不保证保存顺序，重启或跨工作区后可能重排；唯一可靠的是名称和文件路径
- 多根工作区下，书签按工作区文件夹隔离，
Bookmarks: List from All Files仍能汇总全部，但无法按工作区筛选
侧栏书签列表看起来像一个导航中心，但它本质是个只读索引视图：你不能在里面新建、拖动、批量操作书签。所有编辑动作（增删改名）仍需回到代码行或右键条目完成。这点容易被忽略，直到你试图在侧栏里双击某条目想编辑它——结果只是跳转过去而已。
