需安装CSpell中文词典、配置cspell.json启用zh-CN语言及chinese词典、在用户设置中添加"zh-CN"并禁用english词典以准确校验中文拼写。

如果您在使用 VSCode 编写中文注释、字符串或标识符时发现 Code Spell Checker 未正确识别中文词汇,可能是由于插件默认词典未启用中文支持或配置未适配中文语境。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装并启用中文词典扩展
Code Spell Checker 默认不包含中文词典,需手动安装兼容的中文词典包以支持简体中文拼写校验。
1、在 VSCode 中按下 Cmd+Shift+X 打开扩展面板。
2、搜索 code spell checker chinese 或 cspell-dict-chinese。
3、选择由 streetsidesoftware 官方维护的 CSpell Chinese Dictionary 扩展并点击安装。
4、安装完成后重启 VSCode,确保词典加载生效。
二、手动配置 cspell.json 启用中文词典
即使安装了中文词典,若工作区未显式声明启用,插件仍可能忽略中文校验。需通过项目级配置文件明确指定语言支持范围。
1、在项目根目录创建或编辑 cspell.json 文件。
2、在 language 字段中添加 zh 或 zh-CN。
3、在 dictionaries 数组中加入 chinese。
4、保存文件后,VSCode 将自动重新加载拼写检查规则。
三、调整用户设置启用中文语言模式
全局设置可覆盖项目配置,确保所有含中文内容的文件(如 .js、.py、.ts)均被纳入中文拼写检查范围。
1、按下 Cmd+, 打开设置界面。
2、搜索 spell checker language。
3、点击 Edit in settings.json 链接。
4、在 cSpell.language 对应值中追加 "zh-CN",格式为数组形式,例如 ["en", "zh-CN"]。
四、禁用英文词典避免误报干扰
当同时启用英文与中文词典时,部分中文拼音(如 “zhang”、“li”)可能被误判为英文人名而跳过标红。关闭英文词典可提升中文校验准确性。
1、打开命令面板(Cmd+Shift+P)。
2、输入并选择 Preferences: Open Settings (JSON)。
3、将 cSpell.enabledLanguageIds 设置为仅包含目标语言,例如 ["javascript", "python", "typescript"]。
4、在 cSpell.dictionaries 中移除 english,仅保留 chinese。










