Harper语言服务器在文件保存时的性能优化分析

Harper作为一款轻量级语法检查工具，其核心设计理念是"快速且不干扰工作流程"。近期用户反馈在保存大型文件时出现明显的延迟现象，这引发了我们对语言服务器工作模式的深入思考。

问题现象与定位

在Visual Studio Code及其衍生编辑器Cursor中，当用户保存较大代码文件时（3917行甚至1000行级别），会出现3秒以上的明显卡顿。性能分析显示此时Harper语言服务器(harper-ls)会占用大量CPU和内存资源，且存在处理不释放的情况。

深入分析发现，这是由于VS Code默认会在文件保存时主动请求所有已注册语言服务器提供代码操作(Code Actions)，而Harper原本的设计并未针对此场景做特殊处理。虽然Harper本身不提供格式化功能，但语法检查的代码操作请求仍会被触发。

技术决策与解决方案

经过团队讨论，我们做出了以下关键决策：

1. 行为变更：修改默认行为，不再在保存文件时触发语法检查的代码操作请求。这符合大多数拼写检查类插件的常规做法。

2. 性能优化：同时保持对语言服务器核心检查逻辑的性能监控，确保基础功能的响应速度。

3. 渐进式改进：通过PR流程逐步验证变更，经过实际工作场景的充分测试后才合并到主分支。

实际效果验证

在v0.8.3版本发布后，用户反馈表明：

• 文件保存操作恢复即时响应
• 不再出现明显的CPU/内存占用高峰
• 基础语法检查功能保持原有响应速度

经验总结

这个案例给我们带来三点重要启示：

1. 编辑器集成规范：语言服务器需要谨慎处理编辑器生命周期事件，特别是保存这类高频操作。

2. 性能边界意识：即使是轻量级工具，也需要为极端情况（如超大文件）设计保护机制。

3. 用户反馈价值：实际工作场景中的性能痛点（如文件保存延迟）往往能揭示出架构设计中的盲点。

Harper将继续保持对编辑器性能影响的严格监控，确保实现"快速且不干扰"的核心设计目标。