VSCode扩展：如何让DefinitionProvider悬浮窗无需Ctrl始终显示？

一、无代码配置方案（当前无直接支持） #

VSCode目前没有内置设置可以直接让DefinitionProvider的预览悬浮窗无需按住Ctrl就显示，这是编辑器默认的交互逻辑。

二、代码层面整合Hover与Definition功能（避免重复悬浮窗） #

要实现悬浮即显示定义预览和跳转链接，同时避免重复悬浮窗，可以将DefinitionProvider的逻辑整合到HoverProvider中，具体步骤如下：

1. 在HoverProvider中复用定义查询逻辑
   在Hover的实现里，直接调用你原本DefinitionProvider的逻辑获取定义数据，再组合成包含跳转链接的悬浮内容：

   import * as vscode from 'vscode';
   
   export class CustomHoverProvider implements vscode.HoverProvider {
       async provideHover(document: vscode.TextDocument, position: vscode.Position, token: vscode.CancellationToken): Promise<vscode.Hover | undefined> {
           // 获取定义数据（复用原DefinitionProvider的逻辑）
           const definitions = await this.getTargetDefinitions(document, position, token);
           if (!definitions || definitions.length === 0) {
               return undefined;
           }
   
           // 构建带跳转链接的Markdown内容
           const hoverContent = new vscode.MarkdownString();
           // 添加跳转命令链接
           hoverContent.appendMarkdown(`[跳转到定义](${vscode.Uri.parse('command:editor.action.goToDefinition').toString()})\n\n`);
           // 添加定义预览代码块（根据你的定义结构调整）
           definitions.forEach(def => {
               hoverContent.appendCodeblock(def.displayText, document.languageId);
           });
   
           // 允许执行命令链接
           hoverContent.isTrusted = true;
           return new vscode.Hover(hoverContent);
       }
   
       // 原DefinitionProvider中获取定义的逻辑
       private async getTargetDefinitions(document: vscode.TextDocument, position: vscode.Position, token: vscode.CancellationToken): Promise<vscode.Definition[] | undefined> {
           // 复制你原本实现的定义查询代码
       }
   }
   

2. 注册HoverProvider并调整DefinitionProvider（可选）

   • 在扩展激活时注册HoverProvider，确保覆盖目标语言的作用范围。
   • 若不需要默认的Ctrl+悬浮触发Definition预览，可以保留DefinitionProvider注册（用户通过Hover内的链接即可跳转）；也可以直接不注册DefinitionProvider，将所有逻辑整合到Hover中。

3. 避免重复悬浮窗的核心
   通过将定义预览和跳转逻辑统一到HoverProvider，只返回一个悬浮窗，从根源上避免DefinitionProvider和HoverProvider同时触发导致的重复问题。

三、不推荐的hack方式 #

不建议通过修改VSCode内部交互逻辑的方式实现需求，这种做法会引发兼容性问题，且不符合编辑器的用户体验规范。

内容的提问来源于stack exchange，提问作者Sophia