fidget.nvim 中 Psalm LSP 进度通知显示问题解析

在 Neovim 生态中，fidget.nvim 是一个用于显示 LSP 进度通知的插件。近期用户报告了一个关于 Psalm LSP 进度通知无法显示的问题，这实际上反映了 LSP 客户端初始化阶段通知处理的一个常见挑战。

问题本质

当 Psalm LSP 服务器在完全初始化之前就发送进度通知时，fidget.nvim 无法正确处理这些通知。这是由于 Neovim API 的一个限制：插件只能从已经完全初始化的客户端轮询消息。

技术背景

LSP 协议支持服务器在初始化过程中发送进度通知（$/progress），这是一种常见的用户体验优化。然而，Neovim 的 LSP 客户端实现存在一个设计限制：在客户端完全初始化之前，插件无法通过 API 访问这些早期通知。

解决方案

fidget.nvim 通过以下方式解决了这个问题：

1. 实现了对初始化阶段进度通知的特殊处理逻辑
2. 添加了明确的日志警告，帮助用户识别类似情况
3. 优化了客户端状态检测机制，确保能捕获更多边缘情况

对用户的建议

对于遇到类似问题的用户，建议：

1. 确保使用最新版本的 fidget.nvim
2. 检查日志文件中的警告信息
3. 了解不同 LSP 服务器的初始化行为差异

这个问题特别展示了 LSP 生态系统中客户端-服务器交互的复杂性，以及插件开发者需要处理的各种边界情况。通过这个案例，我们可以更好地理解 Neovim LSP 集成的工作机制和潜在限制。