最常用最精准的临时禁用方式是添加抑制注释：鼠标悬停波浪线查看检查ID，如// noinspection UnusedLocalVariable（JetBrains原生）或// eslint-disable-next-line no-unused-vars（ESLint），二者格式与用途不可混用。
怎么用注释临时禁用某一行的检查
最常用也最精准的方式是加抑制注释，但必须写对检查项 ID，错一个字母就无效。ID 不是凭感觉写的，得看悬停提示——把鼠标停在波浪线上，第一行显示类似 Unused local variable 或 Identifier 'foo' is not in camel case，括号里那个就是 ID。
写法分两种：
-
// noinspection <code>UnusedLocalVariable（适用于 JetBrains 原生 Inspection） -
// eslint-disable-next-line <code>no-unused-vars（适用于 ESLint 规则）
注意：UnusedLocalVariable 是类名风格，首字母大写、无下划线；而 no-unused-vars 是 kebab-case，带连字符。两者不能混用。Vue 文件中如果同时启用 ESLint 和 WebStorm 原生检查，得分别加两行注释。
为什么右键 Suppress for statement 有时不生效
这个操作本质是让 WebStorm 自动插入上面那种注释，但它依赖两个前提：光标必须落在“可抑制”的 token 上，且该检查项本身支持抑制（不是所有 Inspection 都能被 suppress，比如语法错误 Parse error 就不行）。
常见失效场景：
- 光标停在空格或换行符上，而不是变量名/函数名上
- 检查来自第三方工具（如 PHPStan、ESLint 插件），Suppress 菜单只对 JetBrains 原生 Inspection 生效
- 文件类型识别错误：比如 .vue 文件被当成 HTML 处理，
Suppress for statement就找不到 JS 部分的检查上下文
验证是否成功：插入后，该行波浪线应立刻消失；若没变，打开 Settings → Editor → Inspections，确认对应检查项是启用状态（勾选），且 Severity 不是 None。
怎么彻底排除一个文件不参与任何检查
适合那些你明确不想改、也不希望 IDE 干扰的文件，比如生成的 API 客户端、打包产物、或遗留脚本。这不是降级，是隔离。
操作路径统一：
- 在项目视图中右键目标文件 →
Mark as Plain Text（最暴力，完全关闭所有语言支持和检查） - 或右键 →
Inspect Code…→ 弹窗右上角齿轮图标 → 勾选Exclude from inspection
区别在于：Mark as Plain Text 连语法高亮都关了；Exclude from inspection 保留高亮和补全，只停掉波浪线和悬停提示。后者更常用。注意：这个设置会写入 .idea/misc.xml，团队协作时建议加到 .gitignore 里，避免误提交。
别把 Suppress 当成全局开关来用
很多人一看到满屏报错，就挨个右键 Suppress，结果文件顶部堆了十几行注释，还漏掉嵌套作用域里的同类问题。这是典型误用。
真正该优先做的顺序是：
- 先确认是不是文件类型识别错了（比如 .ts 文件被当成 JavaScript）
- 再查是不是 ESLint / TypeScript 配置没加载（看状态栏有没有
ESLint或TypeScript小图标） - 最后才考虑局部抑制——而且只压住那一处，不是整块逻辑
Suppress 注释不会跨文件生效，也不会影响其他编辑器行为。它只是告诉当前 WebStorm：“这一行，我负责，你别管。” 所以它看起来省事，实则边界极窄，容易掩盖真实配置问题。
