Code Spell Checker 支持法语、德语等拉丁/西里尔语种,需在 settings.json 中配置 language 并安装对应 cspell-dict- 扩展;中文因无拼写概念不适用,建议用专用校对工具或添加拼音白名单。

VSCode 的 Code Spell Checker 插件支持多语言拼写检查,但默认只启用英语,其他语言需要手动配置才能生效。
如何添加中文、日文、法语等非英语语言
插件本身不内置中文或日文词典(因拼音/假名无明确“拼写”规则),但支持如法语、德语、西班牙语、葡萄牙语、俄语等拉丁/西里尔字母语言。添加方法如下:
- 打开 VSCode 设置(Ctrl+, 或 Cmd+,)→ 搜索 spell
- 找到 Code Spell Checker: Language 设置项
- 点击右侧铅笔图标 → 编辑 settings.json
- 在
"cSpell.language"字段中加入目标语言代码,例如:
"cSpell.language": "en,fr,de,es,pt,ru"
中文拼写检查的现实限制与替代方案
Code Spell Checker 对中文基本无效——它依赖“单词分割+词典匹配”,而中文没有空格分词,也不适用“拼写”概念。如果你看到中文被标红,通常是插件把整个中文字符串当成了未识别英文单词。
- 真正需要中文校对,建议用专门工具:如 Typora 内置校对、Word、或在线服务(秘塔写作猫、火龙果)
- 若只是想避免中英文混排时误报,可在设置中添加 codeWords 白名单,例如将常用中文拼音或术语加入:
"cSpell.words": ["zhongwen", "shanghai", "weixin"]
自定义词典和项目级配置
团队协作或特定项目常有专有名词(API 名、缩写、内部术语),靠全局设置不够灵活。
- 在项目根目录新建 .cspell.json 文件,内容示例:
- { "version": "0.2", "language": "en,fr", "words": ["myapi", "devops", "grpc"], "ignorePaths": ["node_modules/**", "dist/**"] }
- 保存后,插件会自动优先读取该项目的配置,无需重启
常见问题:为什么加了语言还是不生效?
不是所有语言都开箱即用,部分需额外安装词典扩展:
- 打开扩展市场,搜索 cspell-dict- + 语言名(如 cspell-dict-fr)→ 安装对应词典扩展
- 确认文件类型是否被支持:默认检查
plaintext、markdown、javascript等,但像json或yaml中的字符串可能需开启 cSpell.stringsOnly - 检查当前编辑器右下角语言模式(如显示 “Plain Text”),确保不是 “JSON” 或 “Markdown” 等受限模式干扰识别
基本上就这些。多语言拼写检查不复杂但容易忽略词典扩展和项目配置这两步。










