vscode需借助Code Spell Checker扩展实现拼写检查,它支持50+语言并能区分代码上下文;配置languageFilter和enabledLanguageIds可精准限定检查范围,关闭checkIdentifiers可避免误检变量名,支持自定义词典与行级忽略。

VSCode本身不自带拼写检查功能,但通过安装扩展和简单配置,就能实时标记代码、注释、字符串中的拼写错误——关键不是装插件,而是选对插件并告诉它“哪些文字需要检查”。
推荐插件:Code Spell Checker
这是目前最成熟、适配度最高的拼写检查扩展,支持50+语言,能区分代码标识符、注释、字符串、markdown文本等上下文。
- 安装后默认启用,无需额外操作即可检查注释和字符串中的英文单词
- 右键点击标红单词可快速添加到用户词典,避免重复误报
- 支持自定义词典(jsON格式),适合项目专用术语(如 “reactQuery”、“ZodSchema”)
- 可在设置中关闭对变量名、函数名的检查,防止干扰开发逻辑
让拼写检查更精准:配置 languageFilter 和 enabledLanguageIds
默认情况下,它会对所有打开的文件启用检查,但你可能只想检查 README.md、.ts 文件里的注释和字符串,而非 JSX 标签名或 css 类名。
- 在 VSCode 设置(settings.json)中添加:
"cSpell.languageFilter": "(?i)^(?!html|css|scss|sass|less|postcss).*$"
表示跳过 HTML/CSS 类文件的拼写检查 - 指定只检查特定语言:
"cSpell.enabledLanguageIds": ["typescript", "javascript", "markdown", "json"]
处理常见误报:忽略代码标识符,聚焦自然语言
拼写检查不该质疑你的变量命名,而应帮你发现 “recieve” 这类明显拼错的注释词。
- 默认已禁用对 identifier(变量/函数名)的检查,若意外触发,确认设置中有:
"cSpell.checkIdentifiers": false - 字符串中混有路径、URL 或占位符(如
"user/${id}/profile")时,插件通常能自动跳过,无需手动加 ignore 注释 - 想临时忽略某行?在行尾加
// cSpell:ignore即可
基本上就这些。配置一次,后续所有项目都能受益——拼写错误不再悄悄溜进 PR,也不用靠人工扫注释找 typo。