code spell checker 中文拼写检查需同时安装官方词典扩展、配置语言代码并绑定文件模式，否则无效；右下角显示语言标识是插件激活的关键标志。

Code Spell Checker 默认只检查英文，其他语言必须手动配对词典、语言代码和文件模式，缺一不可；中文需额外安装官方词典扩展，否则配置 cSpell.language 为 zh-CN 也无效。

确认插件已启用且右下角有拼写状态

插件没真正加载，所有配置都白搭。先看编辑器右下角：是否显示 en、zh-CN 或带 Spell 图标的语言标识？没有就说明插件未激活上下文。

• 打开扩展面板，搜 Code Spell Checker，确认状态是「已启用」而非仅「已安装」
• 按 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux），输入 Spell Checker: Toggle 回车，强制触发一次重载
• 检查 settings.json 里有没有 "cSpell.enabled": false —— 这个全局禁用项会直接屏蔽全部功能

配置 cSpell.language 并安装对应词典扩展

语言代码只是“开关”，不是“词典本身”。比如填了 zh-CN 却没装 cSpell Dict Chinese，插件只会跳过中文段落，不报错也不提示。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 法语/德语/西班牙语等拉丁语系：只需在 "cSpell.language" 中添加 "fr"、"de"、"es"，插件内置基础词典，无需额外扩展
• 中文（zh-CN）：必须安装官方 cSpell Dict Chinese 扩展（作者 streetsidesoftware），第三方“Chinese Spell Checker”不兼容
• 日文（ja）：同样需装 cSpell Dict Japanese，它只校验罗马音拼写，不处理汉字语义
• 保存 settings.json 后务必重启 VSCode，词典包不会热加载

绑定文件语言模式与启用字符串/注释检查

VSCode 拼写检查高度依赖当前文件的 languageId。如果 README.txt 被识别为 plaintext，但 cSpell.enabledLanguageIds 里没包含它，就不会触发检查。

• 点击右下角语言标识（如 Plain Text），选「Configure File Association for '.txt'」→ 改为 markdown 或 plaintext
• 在 settings.json 中显式声明支持的文件类型："cSpell.enabledLanguageIds": ["markdown", "plaintext", "javascript", "typescript"]
• 默认只检查字符串和注释，不查变量名；若发现 recieveData 没标红，大概率是 cSpell.checkIdentifiers 被设为 true 或文件模式错误
• 避免误报驼峰名，加 "cSpell.checkCamelCase": true，否则 useStore 会被拆成两个独立单词校验

中文拼写检查的实际边界在哪

Code Spell Checker 对中文本质是“伪支持”：它不校验语义、不切分词语、不识别语法，只靠拼音匹配和字符组合规则做粗筛。你看到的“标红”，90% 是整段中文被当英文单词查空词典的结果。

• 真正有效的中文校对要靠专用工具（如秘塔写作猫、火龙果），不是拼写插件
• 若只是防中英文混排误报，用 cSpell.words 加拼音白名单更可靠，例如："zhongwen", "shanghai", "weixin"
• cSpell.allowCompoundWords: true 必须开启，否则中文混合英文缩写（如 API文档）会全段失效
• 项目级 .cspell.json 比用户级 settings.json 更可控，尤其适合团队共享术语表

最常被忽略的是词典扩展安装和文件语言模式绑定——这两步不做，后面所有配置都是静默失效。别急着调参数，先让右下角出现 zh-CN 或 fr 标识，再往下走。