自定义语言服务器VS Code扩展补全不显示问题排查

针对你遇到的{触发补全后VS Code不显示弹窗，但请求已发送且结果合法的问题，可按以下步骤排查：

• 检查VS Code的触发字符配置
  确认你的自定义语言的editor.suggestTriggerCharacters设置没有覆盖或遗漏{。可以在settings.json里添加：

  "[your-language-id]": {
    "editor.suggestTriggerCharacters": ["{", ...] // 确保包含{
  }
  

  有时候全局设置或其他扩展会修改这个配置，导致服务器的触发字符设置被忽略。

• 验证CompletionItem的关键字段
  VS Code的补全过滤逻辑依赖filterText、insertText和range字段：

  • 确保filterText匹配输入的{前缀，比如如果补全项是{ key: value }，filterText可以设为{，让VS Code能匹配到；
  • 检查textEdit.range是否精确覆盖光标所在的位置（即输入{后的光标位置），如果range偏移，VS Code会判定补全项不适用；
  • 若未设置sortText，补全项可能因排序靠后被隐藏，可手动设置sortText为靠前的值（比如"a"）测试。

• 排查括号内的上下文限制
  VS Code会根据语法高亮定义的上下文判断是否显示补全。检查你的语言的tmLanguage.json或language-configuration.json：

  • 确保括号{}被正确定义在brackets数组中；
  • 确认括号内的语法作用域（scope）没有被标记为禁用补全的类型，比如某些字符串或注释作用域会自动阻止补全。

• 检查客户端与服务器的配置冲突
  如果在vscode-languageclient的客户端代码中手动设置了clientOptions.completionProvider，会覆盖服务器返回的triggerCharacters配置。确保客户端代码中没有重复定义：

  // 避免这种覆盖
  const client = new LanguageClient(..., {
    completionProvider: { triggerCharacters: [...] } // 移除或与服务器配置保持一致
  });
  

• 查看LSP日志定位细节
  打开VS Code的「输出」面板，选择「Language Server Protocol」日志，查看补全请求的返回结果：

  • 确认每个CompletionItem的textEdit、filterText等字段是否符合预期；
  • 检查日志中是否有VS Code过滤补全项的相关提示（比如因范围不匹配被排除）。

• 排除扩展干扰
  临时禁用其他扩展，或在干净的VS Code窗口（Ctrl+Shift+N）中测试，排除其他扩展的补全逻辑干扰。同时可以尝试设置：

  "editor.suggest.snippetsPreventQuickSuggestions": false
  

  避免内置代码片段阻止自定义补全显示。

内容的提问来源于stack exchange，提问作者Isaac Mills Student