VSCode如何将英文单词的拼写检查设置为忽略特定词汇

用VSCode写代码，最烦人的事情之一，可能就是拼写检查器在你精心命名的变量或API上画红波浪线了。比如你写个“ReactQuery”或者“ZodSchema”，明明是个专有名词，它却偏要提醒你“拼写错误”。

这其实是因为，Code Spell Checker这个插件默认只认识标准英文单词。你项目里那些特有的库名、缩写、甚至是内部约定的术语，对它来说都是“陌生词”。想让编辑器“闭嘴”，你得手动告诉它哪些词需要忽略。

别担心，方法有好几种，从一劳永逸的项目级配置，到灵活的单行控制，再到用正则表达式批量过滤，总有一款适合你。

在项目级配置中添加 words 字段

如果你的项目里有大量反复出现的自定义术语——比如团队内部使用的API名称、特定的第三方库名，或者你自己封装的一系列Hook——那么最干净的办法，就是统一加到项目根目录的 .cspell.json 文件里。

这样做的好处是，配置只对当前项目生效，比修改全局设置更精准，也便于团队协作和版本管理。

• 首先，在你项目的根目录下，找到或创建一个名为 .cspell.json 的文件。
• 确保文件里包含一个 "words" 数组，然后把你想忽略的词汇都放进去。格式大概是这样的：

{  "words": ["ReactQuery", "ZodSchema", "JWT", "APIKey"]}

• 保存文件后，这些词在当前项目的所有文件中，就都不会再触发拼写警告了。

用 // cSpell:ignore 行内临时忽略

有些情况不适合全局配置。比如，某行代码里混着动态生成的路径、占位符，或者一些临时使用的、奇奇怪怪的字符串片段。为它们去修改项目配置，有点小题大做。

这时候，行内注释就派上用场了。

• 你只需要在那行代码的末尾，加上一条特殊的注释：// cSpell:ignore myCustomId, apiV2, userId。
• 它支持用空格或逗号分隔多个词汇，并且是大小写敏感的。
• 最重要的是，这个忽略指令只对当前这一行代码生效，不会影响到文件的其他部分，非常灵活。

通过 cSpell.ignoreRegExpList 批量跳过模式

如果你遇到的是某一类有规律的“干扰项”，比如全是大写字母的缩写（HTTP、UI），或者带下划线的环境变量名（NODE_ENV、API_VERSION），一个个加到单词列表里就太累了。

对付它们，正则表达式才是终极武器。

• 你可以在 settings.json（用户或工作区设置）或者项目的 .cspell.json 中，添加一个 "cSpell.ignoreRegExpList" 数组。
• 比如，加入下面这两个规则：

"cSpell.ignoreRegExpList": ["\b[A-Z]{2,}\b", "\b[A-Z]+_[A-Z_]+\b"]

• 第一个正则 \b[A-Z]{2,}\b 会匹配并跳过所有由两个及以上大写字母组成的单词（像“HTTP”、“UIKIT”）。
• 第二个正则 \b[A-Z]+_[A-Z_]+\b 则专门对付像“NODE_ENV”、“API_VERSION”这类用下划线连接的大写变量。
• 需要注意，在JSON里写正则时，反斜杠需要转义，所以你会看到双反斜杠。另外，这些正则通常不能跨行匹配。

一个常见的“坑”

最后，有个细节特别容易让人困惑：明明已经在 .cspell.json 里加了词，为什么还是标红？

问题可能出在下面两点：

1. 配置文件放错了位置：.cspell.json 必须放在项目的根目录，或者被VSCode识别为工作区文件夹的根目录。如果你把它放在了 src/ 这样的子文件夹里，插件很可能根本读不到它。

2. 文件语言不在检查范围内：Code Spell Checker默认只检查一部分语言。如果你正在编辑的文件类型（比如某种自定义的文件后缀）不在 cSpell.enabledLanguageIds 这个设置列表里，那么拼写检查根本不会启动，你的忽略词列表自然也就无效了。

所以，当配置不生效时，先别急着怀疑人生，检查一下文件位置和语言设置，往往就能找到答案。