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

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 精确控制:

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

帮小忙

腾讯QQ浏览器在线工具箱平台

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

查看详情 VSCode中的Code Spell Checker插件多语言词典配置

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

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

禁用某语言或调整灵敏度

如果发现日语假名提示太频繁(比如把「テスト」标为错误),可临时关闭 ja 词典,或提高容错阈值:

  • cspell.json 中移除 ja,或设 “enabled”: false(需配合自定义词典格式)
  • 添加 “allowCompoundWords”: true 允许连写词(如 “typescript” 不拆成 type script)
  • “minWordLength”: 2 忽略单字/单字母(避免把 “i”、“a”、“我”、“你” 当错词)

这些设置都写在 cspell.json 的顶层或对应 override 块内。

基本上就这些。不用装额外插件,也不用改系统语言,靠配置文件就能让 Code Spell Checker 稳稳支持中日英法德西等多语言拼写检查——关键是语言代码写对、词典路径配准、作用范围划清。

上一篇
下一篇
text=ZqhQzanResources