Code Spell Checker可检测代码中变量名、注释和字符串的拼写错误,如environemnt或initialize拼错,安装后默认生效,支持多语言配置,错误以波浪线标出并提供修正建议;可通过右键添加术语到工作区或用户词典,也可编辑.cspell.json文件自定义单词、忽略路径(如node_modules)和正则匹配内容;与ESLint、Prettier等工具协同使用无冲突,可集成至husky + lint-staged流程或CI中执行自动化检查,提升团队协作效率与代码可读性。

Code Spell Checker 能帮你发现代码中变量名、注释、字符串里的拼写错误,比如把 environment 写成 environemnt,或者注释里把 initialize 拼错,它都会标出来。
安装与基础启用
在 VS Code 扩展市场搜 “Code Spell Checker”,安装后默认就生效。它会自动检查注释、字符串和普通标识符(如变量名),不需要额外配置就能用。首次启用时,右下角可能弹出语言提示,选你常用的语言(比如 English (US))即可。
- 支持多语言,可在设置里添加中文、法语等词典(需手动启用)
- 拼写错误会以波浪线下划线标出,悬停可查看建议修正
- 按 Ctrl+.(Windows/Linux)或 Cmd+.(Mac)快速应用建议
自定义忽略与添加单词
有些词是合理但不在词典里的,比如项目名、缩写、技术术语(如 ReactQuery、zod、tsconfig)。别删波浪线,直接加进用户词典更稳妥。
- 右键拼错词 → “Add to workspace dictionary”(存入当前项目)
- 或 “Add to user dictionary”(全局生效,适合常用术语)
- 也可手动编辑
.cspell.json文件,在words数组里追加单词
精准控制检查范围
不是所有地方都需要拼写检查。比如 JSON 文件里的 key 名、正则表达式、或某些 API 返回字段,拼错也无所谓——可以关掉。
- 在
.cspell.json中用languageSettings针对文件类型开关检查 - 用
ignorePaths排除node_modules/**、dist/**等目录 - 用
ignoreRegExpList忽略匹配正则的文本,比如 URL、版本号、哈希值
配合 ESLint 或 Prettier 使用
Code Spell Checker 和语法/格式工具不冲突,但要注意职责分离:它不管语法对错,也不调整空格缩进。建议把它看作“文字校对员”,ESLint 是“代码教练”,Prettier 是“排版助手”。三者共存毫无问题。
- 无需额外集成,各自独立运行
- 若想提交前统一检查,可加到 husky + lint-staged 流程中(需安装 cspell CLI)
- CI 中可用
npx cspell --no-progress "**/*.{js,ts,md,txt}"做自动化校验
基本上就这些。拼写检查不复杂,但容易忽略——尤其在团队协作或长期维护的项目里,一个拼错的变量名可能让人多花十分钟定位问题。开个插件,加几个词,值得。










