code spell checker 默认不检查中文,需手动安装 cspell chinese dictionary 扩展并配置 cspell.language 为 ["zh-cn"] 和 dictionaries 为 ["chinese"],且文件编码须为 utf-8。

Code Spell Checker 不识别中文,不是语言包问题
装了 Chinese (Simplified) Language Pack for Visual Studio Code 后,编辑器界面变中文了,但注释里的中文词仍被标红——这不是语言包没生效,而是 Code Spell Checker 默认不查中文。它和 VS Code 界面语言完全解耦,得单独配词典。
必须手动安装 CSpell 中文词典扩展
VS Code 自带的拼写检查器(Code Spell Checker)默认只加载英文词典。简体中文词典是独立扩展,不随语言包自动安装。
- 打开扩展面板(
Ctrl+Shift+X),搜索cspell-dict-chinese或code spell checker chinese - 认准发布者是
streetsidesoftware,名称为CSpell Chinese Dictionary - 安装后必须重启 VS Code——不重启,词典不会注册进拼写引擎
cSpell.language 和 dictionaries 必须显式声明
即使装了中文词典,Code Spell Checker 也不会自动对所有文件启用中文校验。它依赖两个配置项:语言白名单 + 词典启用列表。
- 项目级优先:在项目根目录建
cspell.json,确保含以下字段:{"language": ["zh-CN"], "dictionaries": ["chinese"]} - 全局兜底:在
settings.json里加"cSpell.language": ["en", "zh-CN"],避免工作区没配时失效 - 注意:
zh-cn、zh、ZH-CN都无效,只接受zh-CN(大写 CN,短横线)
中文注释仍报错?先确认文件编码和词典加载状态
如果配置都对,但中文还是被标红,大概率是编码或词典未加载成功:
- 右下角状态栏点编码(如
UTF-8),选Reopen with Encoding→UTF-8,强制重载——GBK 编码的中文注释必然触发拼写错误 - 命令面板输
Developer: Toggle Developer Tools,切 Console 标签,搜cspell,看是否有Loaded dictionary: chinese日志 - 若无该日志,说明词典扩展没加载,重装
CSpell Chinese Dictionary并确认没被禁用
真正容易被忽略的是:VS Code 的 locale 设置管界面,Code Spell Checker 的 cSpell.language 管文本校验,两者路径、格式、大小写规则全都不一样,混着改只会互相掩盖问题。











