数字书签插件技术文档

数字书签插件技术文档

vscode-numbered-bookmarks Numbered Bookmarks Extension for Visual Studio Code 项目地址: https://gitcode.com/gh_mirrors/vs/vscode-numbered-bookmarks

---

安装指南

要安装数字书签插件到您的Visual Studio Code编辑器，请遵循以下步骤：

1. 打开Visual Studio Code。
2. 转到左侧边栏中的扩展视图（或者按下Ctrl+Shift+X(Windows/Linux) 或者 Cmd+Shift+X(Mac)）。
3. 在搜索框中输入vscode-numbered-bookmarks。
4. 在搜索结果中找到由Alessandro Fragnani提供的“Numbered Bookmarks”插件，并点击它。
5. 点击“Install”按钮进行安装。
6. 安装完成后，重新加载VSCode（如果需要的话，会自动提示您这样做）。

使用说明

基本操作

• 添加/移除书签: 使用快捷键Ctrl+Shift+数字键0-9在当前行添加或移除对应编号的书签。
• 跳转至书签: 直接通过Ctrl+数字键0-9快速移动光标到对应的书签位置。
• 查看所有书签: 通过命令面板调用Numbered Bookmarks: List来查看当前文件的全部书签。
• 跨文件查看书签: 使用Numbered Bookmarks: List from All Files可以浏览所有打开工作区文件中的书签。

设置个性化选项

1. 在VSCode中打开设置（Ctrl + ,）。
2. 搜索numberedBookmarks以找到相关配置项。
3. 例如，若想保存书签到项目中以便版本控制，将numberedBookmarks.saveBookmarksInProject设为true。

多根工作区支持

确保saveBookmarksInProject设置为true，这样每个工作空间根目录下的书签都将独立管理。

远程开发

该插件支持远程开发环境，无需在远程端再次安装，且可以同步本地与远程的书签状态。

API使用文档

此插件不提供传统意义上的API供其他插件调用，但其通过VSCode的命令系统暴露了一系列可交互的命令，如toggleBookmark, jumpToBookmark, listBookmarks等。这些命令可以通过VSCode的扩展开发接口间接利用，比如在自定义脚本或其它扩展中通过VSCode的API执行这些预定义命令。

安装方式

请参照“安装指南”部分进行插件的安装。此外，对于团队或特定场景下需要手动部署的情况，可以从GitHub仓库下载最新发布版本的.vsix文件，然后在VSCode中通过“Extensions: Install from VSIX…”命令进行安装。

---

注意事项

• 当您在多文件间使用相同编号的书签时，需要合理设置navigateThroughAllFiles以匹配您的需求。
• 请注意，在macOS上，某些默认快捷键可能需要调整，因为它们可能与操作系统级快捷键冲突。
• 插件提供了高度定制性，包括颜色和行为设置，以适应不同用户的偏好。

通过以上指导，您可以充分利用数字书签插件来高效地导航和管理您的代码。

vscode-numbered-bookmarks Numbered Bookmarks Extension for Visual Studio Code 项目地址: https://gitcode.com/gh_mirrors/vs/vscode-numbered-bookmarks