code spell checker 扩展未正确配置或词典覆盖不全是 vscode 中拼写错误未被识别的主因；需依次安装启用扩展、配置工作区词典、切换语言模式、禁用无关文件检查，并支持手动触发与修正。
如果您在使用 VSCode 编写代码时频繁遇到变量名、注释或字符串中的拼写错误，却未被及时识别，则可能是 Code Spell Checker 扩展未正确配置或词典覆盖不全。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 Code Spell Checker 扩展
该扩展需先完成安装并确保处于启用状态，否则无法对任何文本执行拼写检查。VSCode 通过 Marketplace 提供官方维护的 spell checker，支持多语言词典与自定义词库。
1、打开 VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。
2、在搜索框中输入 Code Spell Checker，找到作者为 Street Side Software 的扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”或手动重启 VSCode。
4、确认右下角状态栏出现字母 “ABC” 图标，表示拼写检查已激活。
二、配置工作区专用词典
默认词典可能不包含项目特有术语（如专有名词、缩写、内部 API 名称），导致误报。通过添加用户词典可排除这些合法词汇。
1、在项目根目录下创建文件 cspell.json。
2、在该文件中写入以下基础结构：
3、在 words 数组中添加需豁免的拼写项，例如：["axios", "jwt", "tsconfig"]。
4、保存文件后，VSCode 将自动读取该配置并跳过所列词汇的检查。
三、切换语言模式与启用多语言支持
Code Spell Checker 默认仅检查英语，若代码中混用中文注释、法语文档或德语日志内容，需显式声明支持的语言，否则对应段落不会被分析。
1、按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Windows/Linux）打开命令面板。
2、输入并选择 Change Language Mode。
3、在弹出菜单中选择当前文件对应的语言（如 Markdown 或 TypeScript）。
4、打开设置（Cmd + ,），搜索 cSpell.language，将其值修改为 en, zh, fr 等逗号分隔的语言代码。
四、禁用特定文件类型检查
某些文件（如生成的 bundle.js、min.css 或 node_modules 中的第三方代码）无需拼写校验，禁用可减少误报并提升响应速度。
1、打开 VSCode 设置，搜索 cSpell.enabledLanguageIds。
2、点击“在 settings.json 中编辑”，添加如下条目：
3、在 enabledLanguageIds 数组中移除 javascript 或 css，或添加 "!**/node_modules/**" 到 files.ignored 字段。
4、保存 settings.json 后，对应路径下的文件将不再触发拼写检查。
五、手动触发拼写检查与快速修正
扩展默认实时扫描，但有时需强制刷新或批量修正。手动触发可绕过缓存，确保最新文本被分析。
1、右键点击编辑器任意位置，选择 Spell Check: Check Document。
2、当光标停在红色波浪线下方单词时，按 Cmd + .（Mac）调出建议菜单。
3、从列表中选择正确拼写项，或选择 Add to Workspace Dictionary 将其永久加入当前项目词典。
4、对多个错误，可使用 Cmd + Shift + P 并执行 Spell Check: Fix All Spelling Errors 进行批量替换。
