开发VSCode内联补全插件：如何判断IntelliSense弹窗是否可见？

核心思路是利用VSCode原生维护的**上下文键suggestWidgetVisible**来判断IntelliSense补全弹窗的可见状态，从而在弹窗显示时跳过内联补全的生成逻辑，避免不必要的性能开销。以下是具体实现方案：

方案1：实时获取弹窗状态（简单直接） #

在你的InlineCompletionItemProvider的provideInlineCompletions方法开头，先查询suggestWidgetVisible的值，若为true则直接返回空数组终止补全逻辑：

async provideInlineCompletions(
  document: vscode.TextDocument,
  position: vscode.Position,
  context: vscode.InlineCompletionContext,
  token: vscode.CancellationToken
): Promise<vscode.InlineCompletionList | undefined> {
  // 获取IntelliSense弹窗的可见状态
  const suggestWidgetVisible = await vscode.commands.executeCommand<boolean>('getContext', 'suggestWidgetVisible');
  if (suggestWidgetVisible) {
    return { items: [] }; // 跳过补全生成，节省性能
  }

  // 你的内联补全核心生成逻辑
  // ...
}

方案2：监听状态变化+本地缓存（性能更优） #

如果补全触发频率较高，每次调用executeCommand会有轻微开销，可以通过监听窗口/光标事件维护本地状态变量，避免重复查询：

let isSuggestWidgetVisible = false;

export function activate(context: vscode.ExtensionContext) {
  // 初始化弹窗状态
  vscode.commands.executeCommand<boolean>('getContext', 'suggestWidgetVisible').then(val => {
    isSuggestWidgetVisible = val;
  });

  // 监听光标移动事件，实时更新弹窗状态（比窗口状态监听更精准）
  const cursorChangeListener = vscode.window.onDidChangeTextEditorCursorPosition(() => {
    vscode.commands.executeCommand<boolean>('getContext', 'suggestWidgetVisible').then(val => {
      isSuggestWidgetVisible = val;
    });
  });

  // 注册内联补全提供者
  const inlineProvider = vscode.languages.registerInlineCompletionItemProvider(
    { pattern: '**' }, // 替换为你的目标文件/语言匹配规则
    {
      provideInlineCompletions() {
        if (isSuggestWidgetVisible) {
          return { items: [] };
        }
        // 你的内联补全逻辑
        // ...
      }
    }
  );

  context.subscriptions.push(inlineProvider, cursorChangeListener);
}

方案3：结合触发类型精细化控制 #

可以根据内联补全的触发类型做更灵活的判断：比如自动触发（用户输入时）跳过，手动触发（用户主动调用内联补全命令）则继续执行：

async provideInlineCompletions(document, position, context, token) {
  const suggestWidgetVisible = await vscode.commands.executeCommand<boolean>('getContext', 'suggestWidgetVisible');
  
  // 仅在自动触发且弹窗可见时跳过，手动触发不受限制
  if (suggestWidgetVisible && context.triggerKind === vscode.InlineCompletionTriggerKind.Automatic) {
    return { items: [] };
  }

  // 你的内联补全逻辑
  // ...
}

注意事项 #

• suggestWidgetVisible是VSCode原生上下文键，会准确反映所有补全弹窗（包括第三方插件的补全弹窗）的可见状态；
• 无论哪种方案，都要保证内联补全核心逻辑的高效性，即使跳过判断也能快速响应；

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