VSCode中的Code Spell Checker插件多语言词典配置-VSCode-PHP中文网

VSCode中的Code Spell Checker插件多语言词典配置

P粉986688829

发布： 2025-12-09 17:23:14

原创

649人浏览过

Code Spell Checker 支持多语言需手动配置语言代码而非安装多个插件；在设置中添加 cspell.language 值如 zh-CN,ja,fr,de,es，或通过 cspell.json 的 language、words、overrides 等字段精细化控制词典启用、自定义词汇及按路径/文件类型指定语言。

vscode中的code spell checker插件多语言词典配置

Code Spell Checker 插件默认只启用英语词典，要支持中文、日文、法语等其他语言，需手动配置多语言词典——关键不是装多个插件，而是告诉插件“哪些语言需要检查”以及“用哪套词典规则”。

启用目标语言的内置词典

插件自带部分主流语言词典（如 en-US、en-GB、zh-CN、ja、fr、de、es 等），但默认不激活。打开 VSCode 设置（Ctrl+, 或 Cmd+,），搜索 cspell.language，找到 Code Spell Checker: Language 选项，在输入框中填入逗号分隔的语言代码：

zh-CN（简体中文）
ja（日语，仅检查片假名/平假名/罗马音拼写，不校验汉字语义）
fr,de,es（法/德/西语，支持常见变音符号）

保存后，插件会自动加载对应语言的基础词典，对注释、字符串、变量名中的对应语言文本进行拼写提示。

添加自定义词典文件（如专业术语、项目专有名词）

内置词典覆盖有限，尤其遇到缩写、API 名、内部模块名时容易误报。可在工作区根目录创建 cspell.json 文件，通过 words 字段追加专属词汇：

{
  "version": "0.2",
  "language": "en,zh-CN,ja",
  "words": ["Vue3", "Pinia", "vitepress", "umi", "antd"],
  "ignorePaths": ["node_modules/**", "dist/**"]
}

登录后复制

这样，“Pinia”就不会被标红；language 字段必须显式列出所有启用语言，否则新增词典可能不生效。

按文件类型或路径启用不同语言

一个项目常混用多种语言：JS 文件里主要是英文+少量中文注释，Markdown 里中英夹杂，而 .md 文档又含大量日文示例。这时可用 overrides 精确控制：

Narration Box

Narration Box是一种语音生成服务，用户可以创建画外音、旁白、有声读物、音频页面、播客等

查看详情

"overrides": [
  {
    "filename": "**/*.md",
    "language": "en,zh-CN,ja"
  },
  {
    "filename": "**/README.en.md",
    "language": "en"
  },
  {
    "filename": "**/src/**/*.{ts,js}",
    "language": "en,zh-CN"
  }
]

登录后复制

每条规则匹配文件路径后，独立指定该范围使用的语言列表，互不影响。