讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

VSCode怎么自定义书签标记的悬停说明

小辰吖_6840

小辰吖_6840

发布时间:2026-11-19 05:30:02

|

352人浏览过

|

来源于php中文网

原创

VSCode书签悬停内容无法自定义,因Bookmarks插件未注册HoverProvider且书签非AST节点;唯一实用方案是使用命名书签配合侧栏列表预览代码行。

vscode怎么自定义书签标记的悬停说明

VSCode 默认不支持为书签(Bookmark)添加自定义悬停说明(Hover Tooltip),Bookmarks 插件本身不提供 hover 文本配置项,所有书签图标悬停时只显示固定格式的 file:line 信息,无法注入 JSDoc、注释或用户定义文本。

为什么书签悬停内容不能像函数那样用 JSDoc 控制

书签是编辑器侧边栏(gutter)的 UI 标记,不是语言语义节点——它不关联 AST、不参与类型检查,也不触发 LSP 的 provideHover。VSCode 的 hover 系统只响应语言服务器或扩展注册的 HoverProvider,而 Bookmarks 插件没注册该能力,也未暴露 API 给其他扩展劫持书签 hover 行为。

  • 你写的 /** @description ... */ 注释对书签 hover 完全无效
  • 即使给某行加了命名书签(如 auth-init),悬停时仍只显示 index.ts:42
  • 插件作者明确表示:hover 内容硬编码在 UI 层,无配置入口(见 GitHub issue #327)

唯一可行的变通方案:用命名书签 + 侧栏预览代替悬停

虽然不能改悬停,但 Bookmarks 插件的侧栏列表(Bookmarks: List Bookmarks)会显示每条书签的命名和**代码行片段**,这比默认 hover 更实用:

VSCode节点工具(专业版)
VSCode节点工具(专业版)

面向团队的企业级IDE远程操作平台,含调试、测试、终端、Agent委托与团队协作能力。

下载
  • 打命名书签:Ctrl+Alt+Shift+K(Win/Linux)→ 输入 db-connect-timeout
  • 打开侧栏:Ctrl+Shift+P → 输入 Bookmarks: List Bookmarks
  • 列表中每项含文件名、行号、以及该行前导空格+代码文本(最多约 60 字符)
  • 悬停侧栏条目时,VSCode 会显示完整代码行 tooltip —— 这是 VSCode 原生的“列表项 hover”,不可定制但足够看清上下文

想真正自定义悬停?只能自己写扩展注册 HoverProvider

如果你必须让鼠标悬停书签图标时显示自定义文字(比如从注释提取、或读取配置),就得开发一个轻量扩展,监听 gutter click/hover 事件并手动注入 tooltip。但这要绕过插件限制,且有明显缺陷:

  • VSCode 不允许扩展直接监听 gutter 图标 hover,只能监听整个 editor 区域的 onDidChangeTextEditorSelection 或 onDidMouseMove,再手动判断位置是否靠近书签图标 —— 容易误触、性能差
  • 返回的 Hover 对象必须绑定到某个 Range,而书签没有对应 Range(它只是装饰器),你得伪造一个覆盖行首的 range,导致悬停区域错位
  • 需重复实现书签状态同步(比如用户删了书签,你的 hover 还挂着旧信息)
  • documentSelector 必须匹配当前文件 languageId,否则 registerHoverProvider 根本不生效 —— 这点极易配错(比如 .ts 文件要用 typescript,不是 javascript)

真要这么做,核心陷阱只有一个:VSCode 的 gutter 图标不是文档内容的一部分,任何 hover 都是“模拟”的,稳定性和维护成本远高于收益。日常开发中,老老实实用命名书签 + 侧栏预览,是最省心、最可靠的选择。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1675

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3652

2023.07.21

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2189

2024.03.14

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1787

2024.03.14

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2647

2024.03.15

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1878

2024.03.15

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1302

2024.03.15

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1176

2024.03.15

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn