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,否则说明路径或配置仍有问题


















