VSCode如何开启代码拼写建议单词补全设置方法【技巧】

苏承栈

2026-10-17 • 👁 0人浏览过

VSCode开启单词拼写建议需同时满足三项：editor.wordBasedSuggestions设为true、语言模式非Plain Text、未被其他suggest过滤项屏蔽；它独立于语言服务器，但受localityBonus影响排序。 VSCode 默认就开启基础单词拼写建议（word-based suggestions），但容易被其他设置覆盖或压制，真正起效需要手动确认三项：editor.wordBasedSuggestions 必须为 true、当前语言模式不能是 Plain Text、且没被 editor.suggest.showWords 以外的过滤项屏蔽。 editor.wordBasedSuggestions 设为 true 才触发拼写补全这个设置控制 VSCode 是否基于当前文档已出现的单词做上下文补全（比如你写过

handleClick

，再输

hand

就会提示它）。它和语言服务器无关，纯文本也生效，但默认值在某些版本里是

false

。必须显式设为

true

，不是布尔值

true

就够——要写进

settings.json

，GUI 设置里找不到开关若同时启用了

editor.suggest.showMethods

或

editor.suggest.showClasses

等，而当前上下文没有方法/类，拼写建议可能被挤掉，导致“看不见” 它不依赖扩展，但会被插件劫持：比如某些 Snippet 插件把

Tab

绑定到自己的逻辑，拼写建议弹出来后按

Tab

却不采纳 Plain Text 模式下拼写建议完全失效右下角状态栏显示

Plain Text

时，

editor.wordBasedSuggestions

彻底不工作——这不是 bug，是 VSCode 的设计：它只在识别为代码语言（如

JavaScript

、

Python

）时才启用单词索引。 VSCode 1.118 微软正式发布 Visual Studio Code 1.118 版本。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控。下载常见场景：新建文件未保存（.txt 后缀）、.vue 文件被识别为 HTML、.pyi 文件没配好语言模式验证方式：输一个重复单词（如两次

username

），再删掉第二次的

e

，看是否弹出建议；没弹出就先按

Ctrl+Shift+P

→

Change Language Mode

→ 选对语言注意：即使文件后缀正确，如果项目根目录缺

jsconfig.json

或

tsconfig.json

，JS/TS 文件也可能退化为 Plain Text 行为拼写建议和语言服务器补全共存但互不干扰单词补全是独立通道，和

Pylance

、

TypeScript Server

提供的类型/签名补全并行运行。但它们共享同一个建议框，顺序和可见性由

editor.suggest.localityBonus

和

editor.suggest.preview

影响。若你只看到函数名、看不到拼写词，大概率是

editor.suggest.localityBonus

设得太高（默认

true

），它优先展示“靠近光标”的符号，而拼写词来自全文档想强制拼写词靠前？加配置：

"editor.suggest.localityBonus": false

，但代价是类型补全可能变弱拼写建议不会出现在字符串或注释里——这是硬限制，

editor.quickSuggestions.strings

关或开都不影响它真正卡住拼写建议的，往往不是设置没开，而是语言模式错位或插件静默拦截。先看右下角，再查

settings.json

里那行

editor.wordBasedSuggestions

，最后禁用插件验证——三步下来，90% 的“不提示”问题就定位清楚了。

相关文章