Code Spell Checker 插件支持多语言拼写检查(默认英式/美式英语),可通过cSpell.language添加法语、西班牙语等,中文需额外安装cspell-dict-chinese词典;通过cspell.json的words、ignorePaths及行内注释精准忽略误报;可配置checkIdentifiers、strings和diagnosticLevel适配开发场景。

vscode 的 Code Spell Checker 插件能自动识别代码、注释、字符串甚至 markdown 文件中的拼写错误,帮你省去手动检查的麻烦——关键在于正确配置语言和忽略规则,否则容易误报或漏报。
支持哪些语言?怎么添加新语言
插件默认支持英语(US/UK),但可通过设置轻松扩展。比如要检查中文注释里的英文单词,或支持法语、西班牙语等,只需在设置中修改 cSpell.language 字段:
- 多个语言用逗号分隔,如
"en,fr,es" - 中文本身不参与拼写检查(无词典),但中英混排时,其中的英文部分仍会被校验
- 想启用简体中文术语校验?需额外安装社区词典,例如
cspell-dict-chinese(通过 cSpell.import 引入)
怎么避免误报:合理使用忽略规则
变量名、API 名、缩写、项目专有名词常被标红。与其关闭检查,不如精准忽略:
- 在工作区根目录加
cspell.json,用 words 字段添加自定义词(如"axios", "vuex") - 用 ignorePaths 跳过 node_modules、build 等目录
- 单行忽略:在代码末尾加
// cSpell:ignore next-line或// cSpell:ignore myVarName
怎么让检查更贴合开发场景
默认只检查注释和字符串,但你可以按需调整检查范围:
- 启用对代码标识符的检查(谨慎开启):设 cSpell.checkIdentifiers 为
true,适合校验组件名、函数名拼写 - 禁用对字符串字面量的检查:设 cSpell.strings 为
false,适合大量动态文案场景 - 调整提示级别:把 cSpell.diagnosticLevel 设为
"warning",避免红色下划线干扰视觉
基本上就这些。配好一次,后续所有项目都能复用,拼写问题再不会悄悄溜进 PR 里。