vscode需通过Code Spell Checker扩展实现拼写检查,支持多语言、自定义词典及精细配置;安装后默认检查注释与字符串,红波浪线提示错误,可右键修正或忽略。

VSCode本身不内置拼写检查功能,需借助扩展实现。最常用的是 Code Spell Checker,它轻量、开源、支持多语言,且可灵活配置自定义词典。
安装与基础启用
在扩展市场搜索 “Code Spell Checker”,安装后重启或直接启用即可。默认会检查注释、字符串、变量名等常见位置的拼写,但不会检查关键字(如 if、return)或已知语法标识符。
- 安装后无需额外配置就能工作,适合快速上手
- 拼错的单词下方会出现红色波浪线,悬停可查看建议
- 右键点击可快速添加到用户词典或忽略本次
配置检查范围与语言
通过 settings.json 可精细控制哪些内容参与检查。例如禁用对变量名的检查(避免误报),或为不同文件类型指定语言:
- 添加
"cSpell.enabled": true确保全局开启 - 用
"cSpell.language": "en, zh"同时支持中英文检查 - 通过
"cSpell.words": ["axios", "vuex"]直接内联添加专有名词 - 用
"cSpell.ignorePaths": ["node_modules/**", "dist/**"]跳过无关目录
添加自定义词典(项目级 & 全局)
词典分两级:项目级(推荐)更精准,全局级更省事。项目词典放在项目根目录的 cspell.json 中:
- 新建
cspell.json,写入:{ "words": ["typescript", "eslint", "vite"], "language": "en" } - VSCode 会自动识别并加载,无需重启
- 全局词典路径可通过命令面板运行 Preferences: Open Settings (json),在其中添加
"cSpell.userWords": ["npm", "cli"] - 注意:项目词典优先级高于全局词典
处理误报与例外规则
有些缩写、技术术语或大小写组合容易被误标(如 HTTPStatus、URLs)。可通过正则或格式规则过滤:
- 在
cspell.json中添加:"ignoreRegExpList": ["[A-Z]{2,}"]忽略全大写词组 - 用
"allowCompoundWords": true允许连写词(如 backgroundColor) - 对特定文件类型关闭检查:
"cSpell.enabledLanguageIds": ["javascript", "typescript", "markdown"]
基本上就这些。配置一次,后续开发中拼写问题能及时暴露,尤其对文档注释、配置项名称、API字段等场景帮助明显。不复杂但容易忽略。