code spell checker 默认不检查中文，因其不含中文词典且 language 默认为 "en"；需安装 cspell-dict-chinese、配置 cspell.json 指定 "zh-cn" 和 "chinese" 词典，并启用 html/json 等语言 id 才能生效。

Code Spell Checker 是目前唯一能真正支持中文拼写检查的 VS Code 插件，但开箱即用默认不生效——必须手动装词典、改配置、关英文词典，否则中文根本不会被校验。

为什么默认不检查中文？

插件本身不含中文词典，也不自动启用中文语言模式。即使你写了“welcom”或“recieve”，它能标红；但写成“欢迎”或“登路”（应为“登录”），默认状态下完全没反应。

• cSpell.language 默认只设为 "en"，不包含 "zh-CN"
• 没有安装 cspell-dict-chinese 扩展，插件压根没有中文词汇库
• 同时启用英文和中文词典时，拼音（如 zhang、shu）会被当成人名跳过，导致漏检

必须装的两个东西：插件 + 中文词典

缺一不可。只装 Code Spell Checker 插件，中文永远不报错；只装词典不配语言，也白搭。

• 在扩展面板搜索 Code Spell Checker，装 streetsidesoftware 官方版
• 再搜 cspell-dict-chinese 或 code spell checker chinese，装官方维护的中文词典扩展
• 装完不用重启，但必须下一步配置才生效

cspell.json 里要写的三件事

项目级配置文件才是团队协作的唯一可靠方式，settings.json 里的用户配置无法提交、不同步、易覆盖。

VSCode

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

下载

• "language": "zh-CN" —— 明确指定中文，别写 ["en", "zh-CN"]，否则拼音干扰严重
• "dictionaries": ["chinese"] —— 告诉插件加载刚装的中文词典
• "words": ["登录", "登出", "鉴权"] —— 加入项目高频术语，避免反复右键添加

注意：cSpell.allowCompoundWords 对中文无效，别开；cSpell.checkCamelCase 也建议关掉，中文命名不用驼峰。

容易被忽略的坑：HTML 和 JSON 文件里的中文

插件默认只检查 javascript、typescript、markdown 等语言 ID 对应的文件类型。HTML 标签内文本、JSON 的字符串值，往往被漏掉。

• 要在 cspell.json 里加 "enabledLanguageIds": ["html", "json", "javascript", "typescript"]
• 特别注意 json 类型：如果 package.json 里写 "descripton": "用户管理模块"，不启用 json 就永远不提醒
• "ignorePaths" 别漏掉 "**/*.min.js" 这类构建产物，否则压缩后乱码会触发大量误报

真正卡点不在安装，而在「让插件只对真实中文文本敏感，又不把拼音当人名放过」——这得靠关英文词典 + 单独启用中文 + 项目级 cspell.json 三者配合，少一个都不行。