Code Spell Checker 是 vscode 中轻量实用的拼写检查扩展,支持注释、字符串等场景,默认检查英文,可配置多语言、自定义词典、忽略规则及禁用中文误报,与 ESLint 等工具无冲突。

VSCode 的 Code Spell Checker 是一个轻量但实用的拼写检查扩展,专为代码注释、字符串、变量名(可选)等场景设计,能有效减少文档和代码中的低级拼写错误。
安装与基础启用
在 VSCode 扩展市场中搜索 “Code Spell Checker”,点击安装并重启编辑器(通常无需重启,启用后立即生效)。安装后默认自动检查当前文件中的注释和字符串内容,不检查关键字或语法结构,因此不会干扰编码逻辑。
- 检查范围包括:单行/多行注释(
//、/* */、#)、双引号/单引号/反引号包裹的字符串 - 默认语言为英语(US),如需支持中文,需额外配置——该扩展原生不检查中文,但可禁用对中文的“误报”(见下文)
- 拼写错误会以波浪线下划线标出,悬停显示建议词,右键可快速更正或添加到用户词典
自定义词典与忽略规则
项目常含专有名词(如 API 名称、内部模块、缩写),需手动加入词典避免频繁误报。可在工作区根目录创建 cspell.json 配置文件,或通过命令面板(Ctrl+Shift+P → “Preferences: Open Settings (json)”)添加用户级设置。
- 添加自定义词:右键波浪线 → “Add to workspace cspell.json” 或 “Add to user cspell.json”
- 忽略特定模式:在
cspell.json中配置"ignoreRegExpList",例如"ignoreRegExpList": ["b[A-Z]{2,}b"]可跳过大写字母缩写 - 禁用中文误报:添加
"language": "en"并启用"allowCompoundwords": true,再配合"ignoreRegExpList"过滤中文字符串(如"[u4e00-u9fa5]+")
多语言与团队协作支持
支持英语(US/UK/CA/AU)、西班牙语、法语、葡萄牙语等十余种语言,可通过 cspell.json 的 "language" 字段指定,或使用文件顶部注释临时切换:
- 在文件开头添加
// cSpell:language es即对该文件启用西班牙语检查 - 团队共用词典:将
cspell.json提交至 git,统一拼写规范,避免成员各自添加私有词导致差异 - 配合 ESLint 或 Prettier 不冲突:它只做拼写检查,不影响代码格式或语法校验
常见问题处理
若拼写检查未生效,优先检查以下几项: