WebStorm中ESLint不生效的根本原因是未正确加载项目本地配置：必须安装本地eslint包、使用eslint.config.js（v9+）并export default[]、Vue/TS需装对应插件及绑定文件类型，且须手动指定package与配置文件路径。
WebStorm 里 ESLint 插件本身不更新，更新的是项目里的 eslint 包和配置文件
WebStorm 自身没有叫“ESLint 插件”的独立可升级组件——它只依赖你项目中安装的 eslint（v8/v9）、@typescript-eslint/parser、eslint-plugin-vue 等 npm 包。所谓“更新 ESLint 相关插件”，本质是升级这些本地依赖 + 同步配置变更。
确认当前 ESLint 版本是否支持 WebStorm 2026.x
WebStorm 2026.1+ 原生支持 ESLint v9（仅认 eslint.config.js），但会静默忽略 v9 之前的 .eslintrc.js。如果你升级了 eslint 到 v9，却仍用旧配置名或旧导出格式，WebStorm 就当没这回事。
- 运行
npx eslint --version查看实际版本 - 检查项目根目录是否存在
eslint.config.js，且内容为export default []数组格式 - 若用
eslint.config.ts，需在 WebStorm Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint 中勾选Enable experimental TypeScript config support - 旧版
.eslintrc.cjs在 v9 下完全不生效，删掉或重命名为eslint.config.js
Vue/TS 文件不校验？重点查三处绑定
WebStorm 默认只对 .js 和 .jsx 启用 ESLint。Vue 单文件中的 <script></script> 或 TS 文件不报错，不是插件没装，而是解析链断了。
- 确保已安装对应解析器：运行
yarn add --dev @typescript-eslint/parser @typescript-eslint/eslint-plugin（TS）或yarn add --dev eslint-plugin-vue（Vue） -
eslint.config.js中必须显式声明plugins: ['vue']或plugins: ['@typescript-eslint']，并加入extends对应规则集 - Settings → Editor → File Types → 搜索 “Vue”，确认
*.vue已绑定到Vue.js文件类型（否则<script></script>被当纯文本处理） - 改完后必须 重启 WebStorm 或右键项目 →
Reload project from disk，缓存不清理会导致新配置不加载
为什么 npm update eslint 后 WebStorm 还报老错误？
因为 WebStorm 缓存了旧的 node_modules/eslint 路径或解析结果。它不会自动感知 node_modules 内部变化，尤其当你用 pnpm 或 yarn 3 时，真实包路径可能藏在 node_modules/.pnpm/... 深层目录里。
- 进 Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint
- 取消勾选
Automatic configuration，切到Manual configuration - 点击
ESLint package右侧的...，手动导航到真实eslint包路径（例如node_modules/.pnpm/eslint@9.12.0/node_modules/eslint） - 同样手动指定
Configuration file为项目根目录下的eslint.config.js - 点
Apply后，右上角状态栏应显示ESLint: ready，否则说明路径或配置仍有问题
WebStorm 不会主动告诉你“你配错了”，它只会沉默地跳过校验。最常被忽略的是：**配置文件名不对 + 文件类型未绑定 + 手动路径没刷新**——这三处任一出错，就等于没配。
