答案：通过注册Hover Provider并实现provideHover方法，可在VSCode中为指定语言添加自定义悬停提示，支持Markdown格式与语法高亮，结合配置和上下文控制显示逻辑，提升开发体验。
在 VSCode 扩展开发中，如果你想让编辑器在用户将鼠标悬停到代码某处时显示自定义信息，可以使用 Hover Provider。通过实现 HoverProvider 接口，你可以控制悬浮框的内容和格式，从而增强代码提示、文档说明或调试信息的展示能力。
1. 注册 Hover Provider
要在扩展中启用悬停功能，需在激活扩展的 activate 方法中注册一个 HoverProvider。通常使用 vscode.languages.registerHoverProvider 方法，并指定目标语言和提供者对象。
const hoverProvider = vscode.languages.registerHoverProvider('javascript', {
provideHover(document, position, token) {
// 返回悬停内容
}
});
context.subscriptions.push(hoverProvider);
上面的例子为 JavaScript 文件注册了悬停支持。你也可以替换为其他语言标识符，如 python、markdown 等。
2. 实现 provideHover 方法
provideHover 是核心方法，用于生成实际的悬浮内容。它接收三个参数：document（当前文档）、position（光标位置）和 token（取消令牌）。返回一个 Hover 对象或 null。
provideHover(document, position) {
const wordRange = document.getWordRangeAtPosition(position);
const word = document.getText(wordRange);
if (word === 'myFunction') {
return new vscode.Hover({
language: 'javascript',
value: 'function myFunction(x: number): void'
}, wordRange);
}
return null;
}
这里检查当前单词是否为 myFunction，如果是，则显示一段带语法高亮的函数签名。支持 Markdown 字符串，可使用 \`\`\`language\n...\n\`\`\` 包裹代码块。
3. 支持 Markdown 和样式化内容
VSCode 的 Hover 支持富文本展示，推荐使用 Markdown 提升可读性。
return new vscode.Hover([
'**Description**:',
'> This function handles user login validation.',
'',
'\`\`\`js',
'function myFunction(param) {',
' return param * 2;',
'}',
'\`\`\`'
].join('\n'), wordRange);
这样可以在悬浮框中展示加粗标题、引用说明和代码示例，提升用户体验。
4. 结合配置与上下文判断
你可以结合用户配置或文件路径来决定是否显示提示，避免干扰。
const config = vscode.workspace.getConfiguration('myExtension');
if (!config.get('enableHover')) {
return null;
}
// 检查是否在特定目录下
if (document.uri.fsPath.includes('/node_modules/')) {
return null;
}
灵活控制触发条件能让扩展更智能、更实用。
基本上就这些。通过合理使用 Hover Provider，你可以为特定关键词、API 或自定义语法添加清晰的解释说明，显著提升开发体验。不复杂但容易忽略细节，比如范围匹配和返回格式。
