VSCode需通过插件实现拼写检查,推荐Code Spell Checker插件,支持中英文、智能忽略代码标识符、可自定义词典及按文件类型/上下文精细配置。

VSCode 本身不自带拼写检查功能,但通过插件可以轻松为代码、注释、字符串甚至 Markdown 文档提供实时拼写校验。关键是要选对插件,并合理配置,避免误报(比如变量名、函数名被标红)或漏检(比如中文混写、缩写词)。
推荐插件:Code Spell Checker
这是目前最成熟、适配最广的拼写检查插件,支持 20+ 种语言(含中文简体/繁体),能智能区分代码标识符与自然语言文本。
- 自动忽略驼峰命名(userName、APIResponse)、全大写缩写(URL、ID)、数字组合(userId123)
- 支持自定义词典,可添加项目专有词汇(如 VuePress、NextAuth)
- 右键快捷添加到用户词典或忽略本次,操作直观
- 可单独启用/禁用对注释、字符串、正则、Markdown 等上下文的检查
基础配置(settings.json)
打开 VSCode 设置 → 打开 settings.json,加入以下常用配置项:
"cSpell.enabled": true, "cSpell.language": "en, zh", "cSpell.words": ["vuepress", "nextauth", "zustand"], "cSpell.ignorePaths": ["node_modules/**", "**/dist/**", "**/*.min.js"], "cSpell.stringsOnly": false, "cSpell.enableFiletypes": ["javascript", "typescript", "html", "markdown", "json"]
说明:开启中英文双语检查;添加项目术语到白名单;跳过构建目录和依赖;默认检查所有文本内容(包括注释和字符串);限定在常用文件类型中生效。
进阶技巧:按需启用检查范围
避免干扰开发节奏,建议精细化控制检查区域:
- 只检查注释和字符串(不检查变量名):
"cSpell.stringsOnly": true - 禁用对 JSON 文件的检查(因 key 名常为缩写):
"cSpell.enableFiletypes": ["javascript", "typescript", "markdown"] - 为特定文件夹添加专属词典(例如 docs/ 目录下用技术文档术语):在该目录下新建
.cspell.json,写入{"words": ["vitepress", "rehype"]}
补充推荐(按需选用)
如果 Code Spell Checker 无法满足特殊场景,可搭配使用:
- Polish:轻量级,专注 Markdown 和纯文本,适合写文档时快速纠错
- Spelling Navigator:提供更丰富的快捷键导航(跳转下一个错误、批量修复),适合长文档编辑
- Chinese Spell Checker:专为中文错别字优化(如“登录”误写为“登陆”),但仅限 .md/.txt 文件,不推荐用于代码内字符串
基本上就这些。配置好之后重启 VSCode 或重载窗口,拼写错误会以波浪线下划线形式标出,悬停提示修正建议,体验接近 IDE 内置功能。










