webstorm自定义eslint规则不生效的根源在于配置链断裂：必须打包为npm包或显式require本地规则，手动指定eslint.config.js路径，绑定.vue文件类型为vue.js，并配置@typescript-eslint/parser；否则webstorm无法加载、解析或触发修复。
WebStorm 里自定义规则不生效？先确认 ESLint 能否真正加载你的 rule 文件
WebStorm 不会自动识别你写在 eslint.config.js 里的自定义规则，除非它明确知道这个规则来自哪个包、路径是否可解析、导出格式是否合法。常见现象是：规则写了但编辑器里没提示、eslint --fix 命令能跑通，WebStorm 却完全无视。
- 自定义规则必须打包为独立 npm 包（如
eslint-plugin-myflow），或以本地路径形式显式 require —— WebStorm 不支持直接内联函数式 rule 定义 - 若用本地路径，需确保
eslint.config.js中的rules字段引用正确，例如："myflow/no-unexpected-fetch": ["error", { "allowOn": ["mounted"] }]，且该 rule 已在plugins里声明 - 检查 WebStorm 的 ESLint 设置页中 “Configuration file” 是否手动指向了
eslint.config.js，而不是依赖 “Automatic configuration” —— 后者对含本地插件的配置基本失效 - 如果 rule 依赖 TypeScript 类型检查（比如分析
ref()调用链），必须同时配置@typescript-eslint/parser，否则 WebStorm 解析 AST 时直接跳过 script 块
Vue 组件中检测特定逻辑流程（如“setup → api 调用 → ref 赋值”）需要 parser + plugin + file type 三者对齐
只靠写一条 no-missing-api-call-in-setup 规则没用。WebStorm 默认把 .vue 当作模板文件处理，<script></script> 里的 JS 不进 ESLint 流水线，更别说分析执行顺序。
- 确保
Settings > Editor > File Types中 *.vue 已绑定到 Vue.js 类型（不是 HTML 或 Plain Text） -
eslint.config.js中必须包含：parser: "@typescript-eslint/parser"（即使不用 TS，也要用它解析组合式 API）、plugins: ["myflow"]、extends: ["plugin:myflow/recommended"] - 若规则需访问
setup()内部 AST 节点，必须在 rule 实现中使用context.getSourceCode().ast获取完整树，并过滤CallExpression和AssignmentExpression节点 —— 纯正则匹配会被 WebStorm 忽略 - 验证方式：在
.vue文件中故意写错流程（如漏掉const data = ref(null)），看 WebStorm 编辑器左侧是否出现黄色波浪线，而非仅靠命令行npx eslint src/判断
WebStorm 无法触发自定义 rule 的修复建议？Fix 功能受限于 rule 的 fixable 属性和 WebStorm 版本
即使 rule 正确注册、能报错，WebStorm 也不一定提供 Fix ESLint Problems 快捷菜单或自动修复按钮——这不是配置问题，而是能力边界。
- rule 必须显式声明
meta.fixable = "code"，且fix函数返回fixer.replaceText或fixer.insertTextAfter等标准操作，返回字符串或空数组会被 WebStorm 忽略 - 2025.3 及更早版本 WebStorm 对
.vue文件中的fix支持不稳定；升级到 2026.1+ 后才支持在<script setup></script>块内触发修复 - 若右键无菜单，不要反复重启或重载项目——直接用
External Tools配置一条命令：$NodeGloballyInstalled$ $ProjectFileDir$/node_modules/.bin/eslint --fix $FilePath$，绑定快捷键替代 - 注意：WebStorm 的 “Run eslint --fix on save” 选项只对 JS/TS 文件生效，
.vue文件需额外勾选 “Also apply to Vue files”（该选项在 2026.2 版本 Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint 下新增）
调试自定义 rule 在 WebStorm 中是否被加载的最简方法
别靠猜，用 WebStorm 自带日志定位真实加载路径和错误。
- 打开
Help > Diagnostic Tools > Debug Log Settings，添加 logger：com.intellij.lang.javascript.linters.eslint，级别设为 DEBUG - 重启 WebStorm，打开任意
.vue文件，观察idea.log（Help > Show Log in Explorer）中是否有类似Loaded rule 'myflow/no-unexpected-fetch' from .../node_modules/eslint-plugin-myflow/lib/rules/...的记录 - 如果看到
Cannot find module 'eslint-plugin-myflow'或Failed to load config .../eslint.config.js，说明路径不对或 package.json 中main字段未指向正确入口 - 若日志显示 rule 加载成功但无提示，检查该 rule 的
meta.docs.url是否为空 —— WebStorm 某些版本会因缺少 URL 而静默禁用 rule
