Code Spell Checker 是 VSCode 中最常用、配置灵活的拼写检查插件,能实时标记代码、注释、字符串中的拼写错误;支持多语言、自定义词典、忽略路径与正则,可协同 ESLint 等工具提升代码可读性与协作质量。

Code Spell Checker 是 VSCode 中最常用、配置灵活的拼写检查插件,能实时标记代码、注释、字符串中的拼写错误,对提升代码可读性和协作质量很有帮助。
安装与基础启用
在 VSCode 扩展市场搜索 Code Spell Checker,点击安装并重启(部分版本无需重启)。安装后默认即启用,会自动检查注释、字符串、变量名等常见位置的单词拼写。首次运行时可能提示选择语言,建议勾选 English(主力)和项目实际使用的语言(如 Chinese 可用于识别中文拼音误写,Python 或 JavaScript 会加载对应技术词典)。
关键配置项说明
通过 Settings → Extensions → Code Spell Checker 或 settings.json 调整行为:
-
cSpell.language:指定主语言,如
"en"、"en, zh"(支持多语言逗号分隔) -
cSpell.enabledLanguageIds:控制哪些文件类型启用检查,例如
["javascript", "python", "markdown", "json"],可排除"dockerfile"等无需拼写的类型 -
cSpell.allowCompoundWords:设为
true可避免把userInput拆成user和Input分别报错 -
cSpell.ignorePaths:填入
["node_modules/**", "dist/**"]忽略第三方或构建目录
添加自定义词典与忽略词
项目中常有专有名词(如团队名、产品名、API 接口名),不希望被标红:
- 右键红色波浪线下划线单词 → “Add to Workspace Dictionary”,会自动写入项目根目录下的
.cspell.json或cspell.json - 手动编辑
.cspell.json,在"words"数组中添加词条:"myApiService", "devopsTeam" - 用
"ignoreRegExpList"忽略特定模式,比如"^HTTP[A-Z]*$"跳过全大写协议名
与其他工具协同
它不替代语法检查,但可和 ESLint / Pylint 配合使用:
- 拼写错误高亮是纯文本级,不影响编译或 lint 结果
- 在提交前运行
Ctrl+Shift+P → “Code Spell Checker: Show All Problems”快速扫一遍注释和文案 - 搭配 EditorConfig 或 Prettier 无冲突,因它只读不改格式
基本上就这些。配置一次,后续多数项目开箱即用,小细节容易忽略但很实用。










