Code Spell Checker 仅检查注释、字符串和纯文本中的自然语言拼写,不校验代码标识符(如useStaet)、语法或类型错误;中文支持弱,需手动启用词典或关闭检查;需配置ignoreRegExpList和重载配置才能正常工作。

Code Spell Checker 不能防止程序 Bug,它只检查自然语言拼写,对变量名、函数名、语法错误完全无感。把 environemnt 拼错成 environment 这类问题它能标出,但把 useState 写成 useStaet —— 它不会报错,因为那是合法的 JavaScript 标识符,不是“拼写错误”。
为什么 useState 拼错了它不提醒?
插件默认只检查注释、字符串字面量和纯文本文件中的单词,不扫描代码标识符(如变量、函数、类名)。即使你启用了 cSpell.wordsOnlyCheckInCommentsAndStrings: true,它也依然不会去解析 AST 或校验 JS/TS 的命名合法性。
- 它依赖词典匹配 + 分词规则,不是类型系统或语法分析器
-
useStaet不在英语词典里,但它被当作“未知专有名词”跳过,而非错误 - 若想捕获这类问题,得靠 TypeScript 的类型检查、ESLint 的
no-undef或自定义命名规则
哪些地方它真能起作用?
它真正有效的场景很具体:注释里的英文描述、Markdown 文档、JSON/YAML 中的中文/英文字段说明、日志字符串、HTML 的 title 或 alt 属性值。
- 注释中写
// initilize the store→ 会标红initilize,建议initialize - 字符串中写
console.log("recieve data")→ 标红recieve,建议receive - Markdown 中写
## Deply to prodution→ 同时标红两个词 - 但
const recieveData = () => {}→ 完全静默,不提示
cSpell.language 设成 ["zh", "en"] 为什么中文还是被标红?
因为 Code Spell Checker 对中文没有真正意义上的“拼写检查能力”。它只是把连续中文字符当做一个整体去查词典——而官方中文词典极简,且不支持分词。你看到的红波浪线,其实是插件把整段中文当成一个“未识别英文单词”处理的结果。
- 不是拼写错误,是“无法识别”
- 安装
cspell-dict-chinese插件后仍需在cspell.json中显式启用:"dictionaries": ["chinese"],否则无效 - 更现实的做法是关闭中文检查:
"cSpell.language": ["en"],再用"cSpell.words"加入拼音白名单(如"shanghai","weixin")避免误报 - 需要真正中文校对,请用 Typora、火龙果或秘塔写作猫等专用工具
如何让提示不干扰写代码?
默认配置下,它会在正则表达式、十六进制颜色、URL、版本号等地方疯狂报错,这不是 bug,是它没被告诉“这些不是自然语言”。
- 在项目根目录
cspell.json中加"ignoreRegExpList": -
"^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$"忽略 CSS 颜色值 -
"https?://[^\s]+"忽略 URL -
"v\d+\.\d+\.\d+"忽略语义化版本号 - 禁用高亮强度:
"cSpell.diagnosticLevel": "hint",让它只灰线提示,不弹警告
最常被忽略的一点:插件不会自动读取你刚改的 cspell.json,除非你保存文件后手动触发一次拼写检查刷新——按 Cmd+Shift+P 输入 Spell Checker: Reload Configuration 回车,否则修改不生效。


















