Code Spell Checker在VSCode中未识别语言或标记拼写错误，需依次启用语言支持、安装对应词典包、绑定文件类型语言模式、调整单词识别范围并手动触发检查。
如果您在VSCode中使用Code Spell Checker扩展进行拼写检查，但发现某些语言未被识别或拼写错误未被标记，则可能是由于语言配置未正确启用或词典缺失。以下是解决此问题的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用目标语言支持
Code Spell Checker默认仅启用英语词典，其他语言需手动激活，否则不会对对应语言的文本执行拼写检查。
1、打开VSCode设置（快捷键 Cmd + ,）。
2、在搜索框中输入 cSpell.language。
3、点击“在 settings.json 中编辑”链接。
4、在 "cSpell.language" 字段中添加所需语言代码，例如：["en","zh","ja","fr"]。
二、安装对应语言词典包
部分语言（如中文、日文、法文）需要额外安装第三方词典包，否则即使启用了语言代码，也不会触发有效检查。
1、在VSCode扩展市场中搜索 code spell checker zh 或 cspell-dict-zh。
2、安装由streetsidesoftware发布的官方中文词典扩展（cSpell Dict Chinese）。
3、重启VSCode使词典加载生效。
三、为特定文件类型指定语言模式
VSCode依据文件后缀自动判断语言模式，若文件无标准扩展名或使用了自定义语法，拼写检查可能无法触发，需显式绑定语言ID与词典。
1、打开任意目标文件（如 README.txt）。
2、点击右下角显示的语言模式（如 Plain Text），选择 Configure File Association for '.txt'。
3、在弹出的下拉菜单中选择 markdown 或 plaintext 等支持拼写的模式。
4、在 settings.json 中补充配置："cSpell.enabledLanguageIds": ["markdown", "plaintext", "javascript"]。
四、调整单词识别范围
默认情况下，Code Spell Checker仅检查纯字母单词，忽略含数字、下划线或连字符的标识符，导致变量名或注释中的混合词不被校验。
1、打开 settings.json 文件。
2、添加配置项："cSpell.allowCompoundWords": true。
3、可选添加："cSpell.ignoreRegExpList": ["\\b[A-Za-z0-9_]+\\b"] 并将其值设为 false 以启用对下划线分隔符的检查。
五、手动触发拼写检查并验证结果
插件不会实时扫描整个工作区，需确保当前文档处于活动状态并满足触发条件，才能看到波浪线下划线提示。
1、确保文档已保存且语言模式正确（左下角显示对应语言名称）。
2、将光标置于疑似拼错的单词上，等待约2秒。
3、若出现红色波浪线，悬停查看提示；若无反应，按快捷键 Cmd + Shift + P，输入 Spell Checker: Toggle 手动开关检查状态。
