为何LSP限制补全项的文本编辑范围必须为单行？

首先来看LSP规范原文：

The text edit's range as well as both ranges from an insert replace edit must be a [single line] and they must contain the position at which completion has been requested.

这个限制的核心原因很直接：客户端（比如VS Code）会直接过滤掉包含多行编辑范围的补全项。

LSP作为跨编辑器/IDE的通用协议，设置该约束主要是为了保证不同客户端之间的行为一致性——不同客户端对多行补全的处理逻辑可能存在差异，统一限制为单行能避免兼容性问题，同时也契合补全操作“针对当前触发位置附近做局部代码修改”的设计初衷。

举个实际场景的例子：
假设我们有以下代码，在|位置触发补全：

a.|foo(() -> {
    ...
});

我们期望补全后将代码修改为：

a.bar(() -> {
    ...
});

但如果补全项的编辑范围覆盖了多行，就不符合LSP规范要求，会被客户端从补全列表中过滤掉。

内容的提问来源于stack exchange，提问作者Sheng Chen