webstorm通过右侧滚动条颜色标记实时显示错误(红)、警告(黄)和建议(蓝),悬停查看提示、点击跳转;需启用inspections、关闭power save mode,并确保光标精准定位报错元素才能触发alt+enter快速修复。

WebStorm 会实时在编辑器里标出错误,不用等运行或保存——关键是要看懂右侧滚动条的颜色标记和光标悬停提示。
怎么看滚动条上的错误标记
编辑器右侧滚动条就是你的第一道防线:红色块是错误(比如语法错、未定义变量),黄色块是警告(比如未使用变量、== 比较),蓝色块通常是 TODO 或检查建议。鼠标悬停在对应颜色块上,立刻显示具体问题;点击就能跳转到那行代码。
如果没看到这些标记,先确认两件事:
- Settings → Editor → Inspections 中,
JavaScript和TypeScript相关检查项是否已勾选 - 右下角状态栏有没有显示
Power Save Mode——有就点它退出,否则所有检查都静默关闭
为什么 Alt+Enter 有时不弹修复菜单
Alt+Enter 不是全局修复键,它只对“光标正中报错元素”生效。比如函数名拼错了,光标必须落在那个错字上,而不是空格后或括号外;import 缺失时,光标得停在未识别的模块名上,而不是 import 行末尾。
常见失效原因:
- 光标位置不准:波浪线下划线覆盖整行,但可触发意图的位置往往只有几个字符范围
- 意图被禁用:Settings → Editor → Intentions → JavaScript 下的
Unresolved variable or type等子项没勾选 - 文件类型没绑定对:比如
.svelte文件没关联到 Svelte 类型,Alt+Enter在 script 块里就不响应
Inspect Code 菜单和右键检查的区别
右键当前文件 → Inspect Code 是轻量级扫描,只查这个文件,结果聚焦、速度快;顶部菜单 Analyze → Inspect Code 默认扫整个项目,还能自定义 Scope(比如只扫 src/utils)、加载自定义规则配置(如 .idea/inspectionprofiles/ 下的 profile)。
日常开发中:
- 改完一个工具函数,想快速确认没引入新问题?右键文件执行
- 接手一个旧模块,想批量过一遍潜在隐患?用顶部菜单,Scope 选 Custom,路径填模块目录
- CI 流程里需要生成 XML 报告?用命令行
webstorm64.exe inspect,但它会启动新实例,别拿来替代编辑器内检查
ESLint 集成后警告不显示或修复灰掉
WebStorm 显示 ESLint 警告的前提是:本地项目装了 eslint,且配置文件(.eslintrc.js 或 eslint.config.js)存在并被正确识别。如果警告不出现,先检查 Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint 是否启用了 Automatic configuration 或手动指定了配置路径。
修复选项变灰(不可点)通常因为:
- 对应规则本身不支持自动修复(如
no-console、no-alert) - 缺少插件支持:比如用了
@typescript-eslint规则,但没装@typescript-eslint/eslint-plugin - ESLint 配置里写了
"fix": false,或 WebStorm 设置中禁用了Apply quick-fix on typing
最常被忽略的一点:WebStorm 的检查依赖索引完整性。刚打开项目或新增 node_modules 后,右下角进度条没走完前,很多错误不会标出,也不要急着调设置——等索引完成,一切自然就位。











