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，插件只会跳过中文段落，不报错也不提示。
- 法语/德语/西班牙语等拉丁语系：只需在
"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 标识，再往下走。
