OmniSharp/vscode-csharp 扩展中 CodeLens 和语言服务器错误的分析与解决

问题现象

近期在使用 OmniSharp 提供的 C# 语言服务扩展时，部分 macOS 用户遇到了持续弹出的错误通知，导致 Visual Studio Code 中的 C# 开发体验受到严重影响。主要错误表现为：

1. CodeLens 解析失败，提示版本不匹配错误
2. 语言服务器在处理语义模型时出现异常
3. 错误循环出现，使编辑器几乎无法正常使用

错误详情

从日志中可以看到两个主要错误堆栈：

CodeLens 解析错误

Resolve version '2025-04-14T06:35:39.5510880Z-12143-0' does not match current version '2025-04-14T06:35:42.4780840Z-12170-0'

语义模型获取错误

at Microsoft.CodeAnalysis.Document.GetSemanticModelHelperAsync...

这些错误主要出现在以下环境组合中：

• macOS 系统
• Visual Studio Code 最新版本
• C# Dev Kit 扩展
• .NET 9.0.2 SDK

技术背景

CodeLens 是 Visual Studio Code 提供的一项功能，它可以在代码上方显示额外的上下文信息，如引用计数、测试状态等。在 C# 扩展中，这是通过语言服务器协议(LSP)实现的。

版本不匹配错误表明客户端请求的文档版本与服务器当前持有的版本不一致，这通常发生在文档内容快速变化时，服务器未能及时同步更新。

临时解决方案

对于遇到此问题的用户，目前可采取的临时解决方案是：

1. 降级 C# 扩展版本至 2.69.25
2. 同时降级 C# Dev Kit 至 1.17.64 版本

这个组合已被多位用户验证可以暂时规避问题。

官方修复情况

根据项目维护者的反馈，此问题已在最新版本或预发布版本中得到修复。建议用户在确认新版本稳定后，逐步升级至最新版扩展。

最佳实践建议

1. 对于生产环境，建议在扩展更新后观察一段时间再升级
2. 保持开发环境的 .NET SDK 版本与项目要求一致
3. 定期清理 VS Code 的扩展缓存和用户数据
4. 遇到类似问题时，可先检查扩展的 GitHub 仓库中是否有已知问题和解决方案

这个问题展示了现代开发工具链中组件间依赖的复杂性，也提醒我们在享受强大功能的同时，需要关注各组件版本间的兼容性。