VSCode中的Code Spell Checker:多语言拼写检查

18次阅读

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

VSCode中的Code Spell Checker:多语言拼写检查

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)→ 安装对应词典扩展
  • 确认文件类型是否被支持:默认检查 plaintextmarkdownjavascript 等,但像 jsonyaml 中的字符串可能需开启 cSpell.stringsOnly
  • 检查当前编辑器右下角语言模式(如显示 “Plain Text”),确保不是 “JSON” 或 “Markdown” 等受限模式干扰识别

基本上就这些。多语言拼写检查不复杂但容易忽略词典扩展和项目配置这两步。

text=ZqhQzanResources