vscode拼写检查波浪线90%来自code spell checker插件,非vscode自带;悬停看前缀含“cspell”或“unknown word”、右下角有abc图标即可确认;最安全做法是设"cspell.enabled": false并重载窗口,避免误关problems.decorations.enabled导致真实错误隐身。

VSCode 里拼写检查导致的黄色(或红色)波浪线,90% 来自 Code Spell Checker 插件,不是 VSCode 自带功能;关错配置(比如误设 problems.decorations.enabled)会连 TypeScript 类型错误、ESLint 报错一起藏掉——真问题就看不见了。
怎么确认是 cSpell 在画线
悬停在波浪线上,看提示文字前缀:
- 含
cSpell或Unknown word→ 就是Code Spell Checker在扫描 - 右下角状态栏有
ABC图标 → 插件正在运行 - 按
Ctrl+Shift+P→ 输入Developer: Show Running Extensions→ 查看streetsidesoftware.code-spell-checker是否启用
关掉拼写检查最安全的两步
别卸载插件,只禁用检查逻辑,保留插件其他能力(如右键加词):
- 打开
settings.json(Ctrl+,→ 右上角齿轮图标 →Open Settings (JSON)) - 添加这一行:
"cSpell.enabled": false - 保存后按
Ctrl+Shift+P→ 输入Developer: Reload Window重载生效
为什么改了还标黄?检查三层覆盖
常见失效原因不是配置没写对,而是被更高优先级设置覆盖:
- 项目根目录下的
.vscode/settings.json里写了"cSpell.enabled": true→ 它会压过用户级设置 - 语言专属配置如
"[typescript]": { "cSpell.enabled": true }→ 对.ts文件单独开启 - 某些主题(如 Nord、One Dark Pro)把拼写错误样式硬编码进 color theme,换回默认主题验证一下
只想隐藏波浪线,但保留后台检查
如果你仍想让插件扫描单词、只不想看到下划线(比如团队共用配置,但你个人不希望干扰视线):
- 设
"cSpell.showTypes": ["warning"]→ 只显示警告线,去掉"error"和"hint"(红线/绿线就没了) - 或更彻底:设
"problems.decorations.enabled": false→ 所有语言所有来源的波浪线全消失,但Ctrl+Shift+MProblems 面板照常显示全部诊断项 - 注意:
problems.decorations.enabled是全局开关,影响所有错误/警告/提示的渲染,不只是拼写
真正容易被忽略的是:中文注释标红从来不是语法问题,而是 cSpell 把整段中文当“非法英文单词”处理;这时候关掉拼写检查是对的,但千万别顺手关掉 problems.decorations.enabled——它一关,console.lgo 这种低级拼写错误就再也看不见了。











