webstorm代码检测需文件类型识别、检查项启用、光标精准落点三者同时成立；滚动条标记依赖show error stripe开启；f2/shift+f2和alt+enter均严格依赖问题token定位与规则配置。
WebStorm 的代码检测不是“开了就灵”，它依赖文件类型识别、检查项启用、光标精准落点三者同时成立；报错不跳、修复不弹、波浪线不消失，90% 是这三者中某一个断了链。
滚动条没红/黄标记？先确认检查是否真在运行
右侧滚动条是 WebStorm 实时检测的“仪表盘”：红色=错误，黄色=警告，蓝色=提示。没标记≠没错误，而是检测根本没启动。
- 按
Ctrl+Shift+A搜Show Error Stripe，确保勾选——这是滚动条显示的前提 - 进
Settings → Editor → Inspections，展开对应语言（如JavaScript或TypeScript），确认顶层复选框已勾选，且子项如Unresolved variable、Unused symbol未被手动禁用 - Vue / Astro / Svelte 等单文件组件需额外确认插件启用：
Settings → Plugins中Vue.js、Astro、Svelte必须已安装并启用，否则<script></script>块压根不走 JS/TS 检查流程 - 自定义后缀（如
.astro）若未绑定语言类型，F2/Shift+F2 会直接跳过——右键文件 →Override File Type手动指定
F2/Shift+F2 按了没反应？光标可能根本不在“问题区域”
F2 跳下一个高亮问题，Shift+F2 跳上一个，但它们只响应已被 IDE 标记为“可交互”的问题位置，不是整行高亮就能跳。
- 悬停波浪线下方，看 tooltip 是否出现
Inspection 'xxx'—— 没这个，说明该行未被任何检查规则覆盖，F2 不会停 - 光标必须落在报错 token 内部：比如
consloe.log错拼，光标得在consloe任意字母上，停在.后或括号外无效 - ESLint 集成的问题默认不进 F2 跳转队列，需手动执行
Ctrl+Shift+A→Inspect Code触发全量扫描 - 软换行（Soft Wraps）开启时，视觉上一行变多行，但 F2 的“行”始终按源码换行符计数，别被显示骗了
Alt+Enter 弹不出修复？三个硬条件缺一不可
Alt+Enter 不是万能修复键，它是“意图操作（Intentions）”的触发器，严格受限于上下文语义。
- 光标必须正中问题 token：比如缺失 import 的
useState，光标得落在useState字母内，而非行尾或空格处 - 对应检查规则必须启用快速修复：进
Settings → Editor → Inspections，找到该规则（如Unresolved variable），右侧勾选Apply quick-fix on typing和Show fix in editor - ESLint 规则需本地支持
--fix：若no-console报错但无修复选项，说明该规则本身不提供自动修正；若import/no-unused-modules灰掉，大概率是项目里没装@typescript-eslint/eslint-plugin或未配置eslint.enable - Vue 的
defineProps、defineEmits等语法糖不会由 Alt+Enter 自动生成——那是语言服务或 Live Template 的职责，不是意图操作的范围
修复完立刻新报错？格式化和 ESLint 在打架
改完一个错，下一行马上标红，大概率不是代码真错了，而是 WebStorm 内置格式化器和 ESLint 规则冲突，尤其集中在缩进、引号、分号、逗号这些基础项。
- 检查
Settings → Editor → Code Style → JavaScript中的缩进、引号、分号设置，是否与项目.eslintrc里indent、quotes、semi、comma-dangle完全一致 - 禁用 WebStorm 自动格式化：取消勾选
Settings → Editor → General → On Save → Reformat file，改用 ESLint 插件的Fix on save（需在Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint中启用） - 某些规则（如
prettier/prettier）本质是格式化校验，它报错 = 当前代码不符合 Prettier 输出结果，此时 Alt+Enter 通常只给 “Run Prettier” 选项，而不是修改代码逻辑
最常被忽略的一点：WebStorm 的检查体系是分层的——IDE 自带的 Inspections、项目级的 ESLint、插件提供的语言服务，三者独立运行、互不感知。你关掉一个，另外两个照常画线。悬停看提示文字里的前缀（ESLint:、Typo:、Equality operator:），才是精准定位开关的唯一依据。
