VSCode设置editor.wordBasedSuggestions与editor.suggest.showWords的区别及存在原因

两者都用来控制基于当前文档现有词汇的自动补全建议，且遵循「与逻辑」：必须同时开启才会显示这类补全，任意一个关闭就不会出现。它们的核心差异和存在原因如下：

功能定位差异 #

• editor.wordBasedSuggestions：底层数据生成开关
  控制VSCode是否扫描当前文档内容，生成基于现有词汇的补全候选池。简单说，它负责让编辑器准备好这类补全的数据源，没有它，词汇补全的基础数据就不存在。
• editor.suggest.showWords：上层展示控制开关
  属于editor.suggest命名空间下的细分控制项（和showFunctions、showVariables同层级），负责控制是否把已经生成好的词汇类补全建议，在自动补全列表中展示出来。

为何存在两个看似重复的设置？ #

这是VSCode配置分层设计和历史演进共同导致的：

1. 职责拆分带来灵活性：把「数据生成」和「UI展示」拆分开，能实现更精细的控制。比如你可以开启词汇扫描（保留数据生成），但临时关闭showWords隐藏这类建议；或者在大文档中关闭wordBasedSuggestions避免性能损耗，同时不影响其他补全类型的展示。
2. 兼容旧配置的历史遗留：editor.wordBasedSuggestions是更早的配置项，后来VSCode重构补全系统，将各类补全的展示控制统一归集到editor.suggest下，新增了showWords，但为了不破坏旧用户的配置习惯，保留了旧项，最终形成了现在的联动逻辑。

相关设置界面截图 #

• editor.wordBasedSuggestions：
  
• editor.suggest.showWords：
  

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