Eglot与Typst-LSP集成问题分析与解决方案

问题背景

在使用Emacs的LSP客户端Eglot与Typst语言服务器(typst-lsp)集成时，开发者遇到了功能无法正常工作的问题。具体表现为：虽然服务器能够正常启动和初始化，但核心功能如代码补全、诊断信息、文档提示等均无法使用，所有请求最终都会超时。

技术分析

问题现象

通过分析事件日志发现，当用户尝试触发代码补全功能时，服务器对textDocument/completion请求无响应，导致请求超时。类似的问题也出现在其他功能请求上，如格式化和文档提示等。

根本原因

深入调查发现，问题的根源在于Eglot默认发送的workspace/didChangeConfiguration通知与typst-lsp服务器的兼容性问题。根据LSP协议规范，workspace/didChangeConfiguration是一个基础通知，客户端可以在任何时候发送，而无需服务器显式声明支持该功能。

然而，typst-lsp服务器对此通知的处理存在缺陷：它错误地要求客户端必须先注册相关能力才能接收此通知，这与LSP协议规范不符。

解决方案

临时解决方案是在Eglot配置中添加：

(setq eglot-connect-hook nil)

这会阻止Eglot发送初始的配置变更通知，从而绕过服务器的问题。

技术细节

LSP协议规范

根据LSP 3.17规范，workspace/didChangeConfiguration通知具有以下特点：

1. 属于基础通知，不需要服务器能力声明
2. 用于通知服务器客户端配置变更
3. 协议中提到的"动态注册"是可选功能，Eglot当前未实现

服务器行为分析

typst-lsp服务器表现出以下异常行为：

1. 错误地要求客户端注册workspace/didChangeConfiguration能力
2. 对未注册能力情况下收到的通知处理不当
3. 导致后续所有请求都无法正常处理

最佳实践建议

1. 对于typst-lsp用户，建议采用上述临时解决方案
2. 长期来看，应该向typst-lsp项目报告此兼容性问题
3. 在集成新语言服务器时，建议：
   • 首先验证基础功能是否正常
   • 检查服务器日志和客户端日志
   • 对比其他客户端(VSCode等)的行为差异

结论

这个问题典型地展示了LSP客户端与服务器实现之间的兼容性挑战。虽然Eglot遵循协议规范，但某些服务器实现可能存在偏差。开发者需要理解协议规范，才能准确判断问题根源并找到合适的解决方案。对于typst-lsp用户，目前可以通过简单配置绕过此问题，等待服务器端的修复。