OmniSharp/omnisharp-vscode 项目中 Razor 文件加载性能问题分析与优化

在最新版本的 OmniSharp/omnisharp-vscode 项目中，开发者报告了一个关于 Razor 文件加载时 CPU 使用率持续偏高的问题。经过深入分析，开发团队发现这是由于 Razor 语言服务器在处理虚拟 C# 文件时触发了过多的 LSP 协议事件导致的性能瓶颈。

问题现象

当开发者打开包含 Razor 文件的项目时，会观察到以下现象：

1. CPU 使用率持续保持在 100% 左右（在 Mac 上表现为单核满载）
2. 项目加载时间明显延长（从 42 秒增加到 3 分钟）
3. 代码智能感知功能（如 CodeLens）延迟出现

通过日志分析发现，语言服务器在处理 Razor 文件时，会重复触发大量 LSP 协议的 didOpen/didClose 事件，而且部分文件路径存在重复拼接的错误，导致额外的文件打开/关闭操作。

技术分析

深入分析后发现问题的核心在于：

1. LSP 事件阻塞：Razor 服务器为每个虚拟 C# 文件和 Razor 文件触发的 didOpen/didClose 事件会阻塞其他 LSP 请求，因为这些事件在 LSP 协议中有特殊处理优先级。

2. 路径处理异常：部分虚拟文件路径被错误地重复拼接，如：

   /path/to/project/path/to/project/file.cshtml__virtual.cs
   

   这种错误路径导致额外的文件操作和资源浪费。

3. 版本差异表现：

   • 在 2.45 版本中，部分核心功能（如 CodeLens）有时能在文件操作风暴开始前完成初始化
   • 在新版本中，所有操作都被严格序列化，导致整体加载时间延长

解决方案与优化

开发团队通过以下方式解决了这个问题：

1. 减少不必要的 LSP 事件：优化了 Razor 服务器的事件触发逻辑，避免为每个虚拟文件发送 didOpen/didClose 事件。

2. 路径处理修正：修复了导致路径重复拼接的代码逻辑，确保文件路径正确生成。

3. 性能优化：对项目加载流程进行了整体优化，减少了不必要的计算和资源消耗。

优化效果

在修复版本 2.60.26 发布后，性能有了显著提升：

• 项目加载时间从 5 分钟降至约 2.5 分钟（MudBlazor 项目测试数据）
• CPU 使用率在项目加载完成后能更快恢复正常
• 代码智能感知功能响应更及时

开发者建议

对于遇到类似问题的开发者，建议：

1. 确保使用最新版本的 OmniSharp/omnisharp-vscode 扩展
2. 关注项目加载时的 CPU 和内存使用情况
3. 对于大型 Razor 项目，耐心等待初始加载完成
4. 如遇性能问题，可通过收集 dotnet-trace 日志帮助诊断

这次优化不仅解决了特定问题，也为未来 Razor 工具链的性能改进奠定了基础。开发团队表示将继续关注项目加载性能，并欢迎开发者反馈使用体验。