VSCode的Hover无层级顺序，所有内容由语言服务器合并为单一Markdown字符串展示；可通过禁用干扰插件、关闭特定建议选项、确保provider正确注册与异步返回来控制显示内容。
VSCode 不支持调整悬停提示（Hover）的“层级顺序”——它没有类似 IntelliSense 那样的权重排序机制，所有 Hover 内容由语言服务器或扩展统一提供，最终只显示一个合并后的结果。
为什么 hover 没有“谁排前面”的概念
Hover 提示不是多个来源并列展示的列表，而是由 vscode.languages.registerHoverProvider() 返回的单一 vscode.Hover 对象。即使多个扩展同时注册了 provider，VSCode 会把它们的返回内容**合并为一段 Markdown**（按注册顺序拼接），而不是分层或排序显示。
- 你无法让 JSDoc 的描述“压过”类型信息，也无法让 Pylance 的 docstring “优先于” MDN 链接
- 所谓“覆盖”，其实是后注册的 provider 返回了更完整的
MarkdownString，导致前者的部分被视觉上弱化或挤出可视区 - 不存在
hover.priority、hover.weight或类似editor.snippetSuggestions的设置项
实际能控制 hover 内容呈现的三个关键点
虽然不能调“顺序”，但你可以通过以下方式决定最终看到什么：
- 禁用干扰源：AI 插件（如 GitHub Copilot、Sesame AI）常劫持 hover 并只显示自己的摘要。临时禁用它们，再对比原生 hover 是否恢复完整
-
压制特定内容：比如不想看到 MDN 链接，就设
"html.suggest.html5": false和"css.mdnsuggest": false，然后重载窗口 -
确保 provider 生效且不为空：检查当前文件真实
languageId（用vscode.window.activeTextEditor?.document.languageId查），确认 package.json 中activationEvents和contributes.languages与之严格一致
Hover 内容为空或错乱？重点查这三处
常见现象不是“顺序不对”，而是根本没渲染出来：
- 返回的
MarkdownString含未转义的_、*或`—— 改用new vscode.MarkdownString(text, true)启用自动转义 - 在
provideHover里同步读文件或遍历 AST —— 必须异步，返回Promise.resolve(new vscode.Hover(...)) - 用了
```code block```—— Hover 不支持多行代码块，换成单行`const x = 1`或精简关键词高亮
真正难的不是排序，是让 hover 稳定返回你想看的内容。一旦 provider 注册正确、文本转义干净、异步逻辑无阻塞，它就只会显示那一段你构造好的 Markdown —— 没有“第二层”，也没有“被盖住”。
