应通过添加白名单词而非关闭全局拼写检查:右键标红词选“save 'xxx' to dictionary”,或进settings → editor → spelling → dictionaries点+手动添加(支持换行批量);该操作仅对typo检查生效,不影响eslint等逻辑检查。

怎么给 WebStorm 拼写检查加白名单词
直接往词典里加词,比关全局拼写检查更轻量——适合文档型项目或需要保留注释/字符串拼写提示的场景。加词后,userProfileData、tsconfig、zmq 这类技术词就再也不会被标红。
操作路径很明确:右键点击被标红的单词 → 选 Save 'xxx' to dictionary;或者进 Settings → Editor → Spelling → Dictionaries,点下方 + 手动添加(支持换行分隔批量粘贴)。
- 添加的词只对
Typo检查生效,对Equality operator或 ESLint 的camelcase规则无效 - 词典是全局生效的,加一次,所有项目都认
- 中文拼音(如
zhongwen)也能加,但 WebStorm 不做语义识别,只当普通字符串匹配
为什么加了词还是被标红
常见原因是加词位置不对,或根本不是拼写检查在报错。
鼠标悬停在波浪线下划线上,看弹出提示的第一行:
- 如果是
Typo:或Spelling mistake:,说明确实是拼写检查,检查是否加到了正确词典(Dictionaries页面里选的是Custom还是Project?默认用Custom) - 如果是
ESLint:开头,比如Identifier 'acqTime' is not in camel case,那是 ESLint 规则,得去eslint.config.js改camelcase配置 - 如果是
JavaScript → Probable bugs → Equality operator,那是逻辑检查伪装成拼写提示,得去Inspections关掉它,不是词典问题
加词后影响哪些地方
Typo 检查加词只作用于三类上下文:
- 标识符:变量名、函数名、类名(如
apiV2、grpcClient) - 字符串字面量:
const msg = "recieve data"中的recieve(注意:加词后仍可能被 ESLint 的no-misspellings插件报) - 注释:
// handel click event中的handel
不生效的地方包括:
- JSX 属性值(如
data-testid="usr-profile"),除非你额外配置了 JSX 支持 - HTML 标签名或属性名(
<my-comp></my-comp>不走拼写词典) - JSON 文件里的 key(WebStorm 默认不在这类文件启用
Typo检查)
临时忽略单个词比加词典更快?
不是。临时忽略(Ignore word)只对当前文件有效,下次打开照样标红;而 Save to dictionary 是永久生效的。
快捷操作流程:
- 光标停在
acqTime上 → 按Alt+Enter(macOS 是Option+Enter) - 从菜单里选 Save 'acqTime' to dictionary(别选
Ignore word或Disable inspection) - 确认后,该词立刻从所有文件中消失,且无需重启
真正容易被忽略的是:WebStorm 的拼写词典不区分大小写,但驼峰词必须按原写法添加——userProfile 和 UserProfile 要分别加,不能只加一个。











