语言服务器协议(LSP)中诊断严重性缺失问题的分析与建议

在语言服务器协议(LSP)的诊断规范中，关于诊断严重性(severity)的处理存在一个值得关注的设计问题。根据当前协议规定，诊断消息可以省略严重性级别，此时将由客户端自行决定如何解释这些诊断信息——可能被视为错误、警告、信息或提示。这种设计在实际应用中引发了客户端实现不一致的问题。

核心问题在于不同客户端对缺失严重性的默认处理方式存在显著差异。例如，在VSCode生态系统中就出现了两种不同的实现：

• vscode-languageclient默认将缺失严重性的诊断视为错误(Error)
• Monaco编辑器则默认将其视为信息(Info)

这种不一致性会导致相同的诊断信息在不同客户端中呈现不同的严重程度，可能影响开发者的使用体验和工作流程。从技术角度来看，这种差异源于协议规范中缺乏明确的默认值推荐，将解释权完全交给了客户端实现。

经过社区讨论，专家们提出了几个改进方向：

1. 协议规范应明确推荐一个默认严重性级别，虽然不能强制要求所有实现遵循，但可以提供统一的指导原则。考虑到vscode-languageclient已被广泛集成到众多语言服务器中，将Error作为推荐默认值是较为合理的选择。

2. 强烈建议服务器端实现始终明确指定诊断严重性，避免依赖客户端的默认处理。这是最可靠的解决方案，能确保诊断信息在不同客户端中表现一致。

3. 关于通过初始化请求传递客户端默认严重性的提议，专家认为实用价值有限，因为服务器更应关注明确指定严重性，而非适应不同客户端的默认行为。

这一讨论反映了协议设计中的一个重要原则：在提供灵活性的同时，应为常见情况提供明确的指导，避免因实现差异导致用户体验不一致。对于LSP这样的基础协议，保持跨客户端行为的一致性尤为重要。

对于语言服务器开发者，最佳实践是始终为诊断信息指定明确的严重性级别。对于客户端开发者，则应考虑遵循即将明确的协议推荐默认值，以促进生态系统的一致性。这种规范上的完善将有助于提升开发工具的整体质量和用户体验。