VSCode扩展示例：LSP服务对未保存文件的支持问题解析

在开发VSCode语言服务器协议（LSP）扩展时，一个常见但容易被忽视的问题是：为什么语言服务功能（如代码补全和错误诊断）在未保存的临时文件中不起作用？本文将以microsoft/vscode-extension-samples中的lsp-sample为例，深入分析这一现象的技术原理和解决方案。

问题现象

当开发者按照lsp-sample示例的说明运行扩展时，可能会发现：

1. 在新创建的临时文件中（Untitled文档）
2. 即使文件格式显示为"plaintext"
3. 预期的代码补全功能和错误诊断功能均未生效

技术原理

这种现象的根本原因在于VSCode文档选择器（Document Selector）的工作机制：

1. 文档URI的差异：

   • 已保存文件使用file://协议
   • 未保存临时文件使用untitled://协议

2. 默认配置限制： 在lsp-sample示例中，客户端扩展的文档选择器默认只注册了file协议：

   const selector: DocumentSelector = [{ scheme: 'file', language: 'plaintext' }];
   

   这种配置明确排除了untitled协议的文档。

解决方案

要使LSP服务支持未保存文件，开发者可以修改文档选择器配置：

1. 方案一：显式添加untitled协议

   const selector: DocumentSelector = [
     { scheme: 'file', language: 'plaintext' },
     { scheme: 'untitled', language: 'plaintext' }
   ];
   

2. 方案二：使用通配符协议（谨慎使用）

   const selector: DocumentSelector = [
     { scheme: '*', language: 'plaintext' }
   ];
   

最佳实践建议

1. 明确协议需求：根据扩展的实际使用场景决定是否需要支持未保存文件
2. 性能考量：支持untitled协议可能会增加服务器负载
3. 状态管理：注意处理临时文件与保存后文件的状态同步问题
4. 用户提示：对于必须保存才能使用的功能，应提供明确的用户提示

扩展思考

理解这一机制有助于开发者：

• 正确处理VSCode中不同来源的文档
• 设计更灵活的语言服务注册策略
• 优化扩展的内存和性能表现

通过合理配置文档选择器，开发者可以创建出既功能完善又性能优异的LSP扩展，为用户提供无缝的编码体验。