VSCode开发React/Node项目时linter忽略拼写单词列表存放位置

API 探路者

2026-8-27

拼写校验忽略单词配置位置

先通过悬浮提示确认你当前触发拼写下划线提示的是哪类工具，对应配置位置如下：

提示来源为Code Spell Checker（VSCode装机量最高的拼写检查插件，绝大多数默认拼写提示来自这个工具）
按需选一种配置方式即可：
1. 项目共享配置（推荐，团队成员拉取代码后自动生效）：在项目根目录新建cspell.json文件，将特殊单词写入words字段：
```
{
  "words": [
    "自定义特殊单词1",
    "自定义特殊单词2"
  ]
}
```
1. 本地工作区配置：打开VSCode设置，切换到「工作区」标签，搜索Cspell: Words，点击添加项把单词逐个加入即可，配置会存在项目内的.vscode/settings.json里，不会影响其他项目。
2. 单文件忽略：在文件最顶部加注释// cspell:words 特殊单词1 特殊单词2，仅对当前文件生效。
提示来源为ESLint（项目内集成的代码规范校验，一般是安装了eslint-plugin-spellcheck规则）
打开项目根目录的ESLint配置文件（.eslintrc/.eslintrc.js/eslint.config.js），找到spellcheck/spell-checker规则项，把特殊单词加入skipWords数组：
```
rules: {
  "spellcheck/spell-checker": [
    "warn",
    {
      skipWords: ["自定义特殊单词1", "自定义特殊单词2"]
    }
  ]
}
```
提示来源为Stylelint（样式文件内的拼写提示）
打开项目根目录的Stylelint配置文件.stylelintrc，将特殊单词加入ignoreWords数组即可。