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

35次阅读

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

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

星耀云
版权声明:本站原创文章,由 星耀云 2025-12-10发表,共计1425字。
转载说明:转载本网站任何内容,请按照转载方式正确书写本站原文地址。本站提供的一切软件、教程和内容信息仅限用于学习和研究目的;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。本站信息来自网络,版权争议与本站无关。
text=ZqhQzanResources