1. 现象:补全提示从“锦上添花”变成了“互相打架”
1.1 我遇到的具体故障场景
先说结论:我的 VS Code 装到了 69 个插件,然后补全功能开始“精神分裂”。
那天下午我打开一个 Python 项目,正常敲 import requests,按下 . 之后,补全列表弹出来的内容让我愣了半天——同一个函数出现在列表里三四次,有的带绿色图标,有的带蓝色图标,有的干脆是灰蒙蒙的旧版本签名。更离谱的是,Tab 键完全失灵了:我按 Tab 想接受第一条补全,光标却直接往里缩进了四个空格,再按一下,又弹出一条来自某个 AI 插件的“智能补全”,直接把我的代码续写到了下一行。
这不是偶发,是持续性的卡顿。每敲一个字符,补全列表都要转圈 300 到 500 毫秒才弹出来,输入中文注释的时候甚至会出现明显的输入延迟。我切换到别的项目,换个语言(JavaScript、Go、甚至 Markdown),问题依旧存在,只是程度轻重不同。
补充一个更容易感知的现象:状态栏右下角不停闪过“正在加载语言服务”之类的提示,扩展宿主(Extension Host)的 CPU 占用直接飙到 180%。我用 VS Code 多年,说实话这种情况以前也遇过,但一般是单一插件出问题,禁用就好了。这次不一样,我连续禁用了好几个看起来“最可疑”的补全类插件,问题不但没解决,反而在某些场景下更糟了。
1.2 为什么会发生:VS Code 补全的多提供方机制
要理解为什么 69 个插件会让补全打架,得先搞清楚 VS Code 补全功能的工作原理。官方文档里把提供补全的模块称作 CompletionItemProvider,一个插件可以注册一个或多个这样的 Provider。VS Code 本身并不限制同一个文档能挂多少 Provider,默认行为是把所有 Provider 返回的结果合并在一起展示。
合并本身是个好事——比如你有 Python 语言服务、代码片段库、Emmet、AI 助手四个来源,理论上它们各写各的条目标签、排序字段(sortText)、过滤器,最终列表应该是有序的。但问题在于,当插件数量一多,各个 Provider 对“同一个词条”的处理方式会互相影响。比如:
- Pylance 返回了
request.get(),一个代码片段插件也返回了request.get(),另一个 AI 类插件又返回了带注释版本的request.get(),列表里就出现了三份“同名不同源”的条目,光标和键盘操作选中的时候,谁先谁后全看加载顺序。 - 不同 Provider 的
sortText策略不一样,有的希望把符号排序靠前,有的希望把关键词排序靠前。合并排序时,就会出现上一秒字母序正常、下一秒突然插入一条不相关结果的情况。 - 很多补全插件还会设置
commitCharacters、resolveProvider这类属性,当焦点落在列表里时,多个 Provider 同时尝试“解析”你正在看的条目,编辑器主进程和扩展宿主之间来回通信,延迟就是这么来的。
除了经典补全(Quick Suggest 那种弹列表),还有一类是内联补全(Inline Completion),也就是你在打字时、在你光标后面直接出现的灰色预览文本。两者是两套独立机制,但经常出现在同一批补全插件里。AI 助手插件往往注册的是 InlineCompletionItemProvider,而语言服务插件注册的是普通 CompletionItemProvider。当你同时开启了很多插件,而且它们的配置项都默认“允许显示”,就会出现我上面说的:灰字预览和弹窗列表同时出现,甚至互相抢 Tab 键——Tab 在一个语境下是“接受内联建议”,在另一个语境下是“选中补全列表第一项”,冲突几乎肉眼可见。
1.3 为什么只禁用几个“看起来最可疑”的插件还不够
我先按经验把六个有补全嫌疑的插件全禁用了:两个 AI 助手、一个智能代码片段包、一个旧的 Python 补全扩展、一个 HTML 自动闭合工具、一个数据库字段提示扩展。重启后,补全清单里的重复条目确实少了,但输入延迟依旧,而且出现了新问题:某个禁用掉的插件留下了一些配置项,在 settings.json 里指向了不存在的扩展 ID,导致 VS Code 每次启动都会在日志里报 Extension is not installed。
我换了个思路,把问题集中在“内联补全”上,关掉 editor.inlineSuggest.enabled,结果灰字没了,可那个
