需为Code Spell Checker添加自定义词典以排除专业术语误报:一、通过settings.json的cSpell.words添加全局词汇;二、项目根目录建cspell.json配置本地词典;三、用.cspellignore排除特定路径与文件类型。

如果您在使用 VSCode 的 Code Spell Checker 扩展时发现某些专业术语、缩写或项目专属词汇被误标为拼写错误,则需要为其添加自定义词典以排除误报。以下是具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、通过用户设置添加单词到全局忽略列表
该方法适用于少量高频使用的专有词汇,直接写入 VSCode 用户设置中,对所有工作区生效,无需创建独立文件。
1、按下 Cmd + , 打开设置界面。
2、在右上角点击 打开设置(JSON) 图标。
3、在打开的 settings.json 文件中,查找 cSpell.words 字段;若不存在,则手动添加该字段。
4、在 cSpell.words 数组中插入需保留的单词,例如:["React", "TypeScript", "API"]。
二、创建本地 cspell.json 配置文件
该方法适用于中大型项目,支持按项目定制词典、语言规则与检查范围,配置优先级高于全局设置。
1、在项目根目录下新建文件,命名为 cspell.json。
2、在文件中写入基础结构,包含 words 字段用于存放自定义词汇。
3、在 words 数组中添加项目专用词,如:["NextJS", "Vercel", "CI/CD"]。
4、保存文件后,Code Spell Checker 将自动读取并应用该配置。
三、使用 .cspellignore 文件排除路径与文件类型
该方法不直接添加词汇,但可防止拼写检查器扫描含大量非标准术语的文件(如 JSON 数据、日志、第三方库),间接减少误报干扰。
1、在项目根目录创建名为 .cspellignore 的纯文本文件。
2、在文件中逐行填写需跳过的路径模式,例如:node_modules/**。
3、添加特定文件扩展名,例如:**/*.json 或 dist/**。
4、确保该文件位于 cspell.json 同级目录,且未被 Git 忽略(除非有意不共享)。










