Code Spell Checker 扩展拼写检查异常的解决方法包括：一、安装启用扩展并确认激活；二、配置多语言支持与自定义词典；三、通过正则和路径规则排除非文本区域；四、调整诊断级别为 error 并限定检查语言范围。
如果您在使用 VSCode 编写代码时发现变量名、注释或字符串中的拼写错误未被识别或误报频繁，则可能是 Code Spell Checker 扩展的字典配置或语言设置未正确适配当前项目。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 Code Spell Checker 扩展
确保扩展已正确安装并处于激活状态，是所有后续配置生效的前提。该扩展默认启用基础英语词典，但需手动确认其运行状态及权限。
1、打开 VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。
2、在搜索框中输入 Code Spell Checker，确认作者为 Street Side Software。
3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。
4、按 Cmd + Shift + P 打开命令面板，输入 Spell Checker: Toggle 并回车，确认拼写检查已启用。
二、配置语言支持与自定义词典
Code Spell Checker 默认仅检查英语拼写，若项目含中文注释、多语言标识符或特定技术术语，需显式添加语言支持并导入自定义词汇表，避免误标合法命名。
1、按下 Cmd + , 打开设置界面，在搜索框中输入 cSpell.language。
2、点击“在 settings.json 中编辑”，在数组中添加所需语言代码，例如："en", "zh", "python"。
3、在工作区根目录创建 cspell.json 文件，写入以下内容以添加项目专属词汇：
4、在 words 数组中填入项目中合法但非常规的单词，如 "useState", "useEffect", "axios"。
三、排除非文本区域与文件类型
拼写检查器可能对代码结构（如 JSON 键名、正则表达式、十六进制颜色值）产生干扰，需通过文件匹配规则和语法范围排除，聚焦真实自然语言内容。
1、在 cspell.json 中定位 "ignoreRegExpList" 字段。
2、添加正则表达式以跳过常见干扰项，例如："\"^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$\"" 忽略 CSS 十六进制颜色值。
3、在 "languageSettings" 下为特定语言禁用检查，例如为 json 设置 "enable": false。
4、在 "ignorePaths" 中添加 "node_modules/**", "dist/**" 等无需检查的路径。
四、调整高亮级别与错误粒度
默认设置将拼写错误标记为警告（Warning），可能淹没关键问题；可通过修改诊断等级，将严重拼写错误提升至错误（Error）级别，强制开发者响应。
1、打开命令面板（Cmd + Shift + P），输入并执行 Preferences: Open Settings (JSON)。
2、添加配置项："cSpell.diagnosticLevel": "error"。
3、如需仅对注释和字符串启用检查，设置 "cSpell.enabledLanguageIds": ["javascript", "typescript", "python"] 并确保不包含 "source" 等宽泛 ID。
4、重启 VSCode 使诊断级别变更立即应用。
