应关闭 editor → inspections 中的 spelling → typo 检查项,而非字符串内拼写检查;若仍有波浪线,需同步关闭 javascript → probable bugs → equality operator 和 editor → general → typing → show suggestions as you type。

拼写检查干扰变量名或注释时怎么关
WebStorm 默认启用拼写检查,但它会把合法的驼峰命名(如 userProfileData)、缩写(如 jsx、tsconfig)甚至中文注释里的拼音(如 zhongwen)标为“Typo”,光标悬停还弹出建议,非常打断编码节奏。
真正要关的是 Typo 这个 inspection,不是“拼写”字面意思的开关——它藏在全局代码检查体系里,和语法/类型检查同级,关错位置没用。
- 按
Ctrl+Alt+S(Windows/Linux)或Cmd+,(macOS)打开设置 - 左侧导航进
Editor → Inspections - 右上角搜索框输入
spell,快速定位到Spelling → Typo - 取消勾选
Typo左侧复选框(注意:别点错成同级的JavaScript → Spelling,那个是独立的 JS 字符串内拼写检查) - 点
Apply保存,无需重启
为什么关了 Typo 还有波浪线?常见漏点
关掉 Typo 后仍有红色/灰色波浪线,大概率是以下两个干扰项没处理:
-
JavaScript → Probable bugs → Equality operator:这个检查会把==标为“拼写错误式比较”,实际是逻辑警告,但 UI 显示像拼写提示;需手动取消勾选 -
Editor → General → Typing → Show suggestions as you type:如果开启,IDE 会在你打字中途弹出拼写建议浮层,这不属于 inspection,得去 Typing 设置里关
二者都和拼写无关,但视觉上高度混淆,新手常以为“关错了地方”。只要波浪线出现在非字符串/非注释区域(比如函数名、变量声明),优先查这两处。
想保留检查但忽略特定词怎么办
有些项目必须保留拼写检查(比如文档型 Markdown 或国际化文案),但又不想被技术词打扰,这时不该关全局 Typo,而该加白名单:
- 右键点击被标红的单词 → 选择
Save 'xxx' to dictionary - 或进
Settings → Editor → Spelling → Dictionaries,点下方+手动添加单词(支持批量粘贴,换行分隔) - 添加后,该词在所有文件中都不再触发
Typo提示
注意:加词典只对 Typo 生效,对 Equality operator 这类伪装成拼写的逻辑检查无效。
禁用 vs 抑制:什么时候该用哪一种
禁用 Typo 是全局停用,适合绝大多数开发场景;但如果你只希望某段注释或某个配置文件不检查,就该用“抑制”:
- 把光标放在标红行 → 按
Alt+Enter→ 选Suppress for statement或Suppress for file - WebStorm 会自动插入类似
// @ts-ignore的注释(如// spellchecker-disable-line),仅对该处生效 - 抑制适合临时绕过,比如生成的 JSON Schema 注释含大量专业术语;长期项目仍建议加词典或关全局
真正容易被忽略的是:禁用操作只影响当前 inspection profile(默认是 Project Default),如果团队共用自定义 profile,得确认你在改的是正确配置档——看设置窗口右上角 profile 名称是否高亮显示。










