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

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 精确控制:
"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 稳稳支持中日英法德西等多语言拼写检查——关键是语言代码写对、词典路径配准、作用范围划清。