WebStorm中ESLint不报错或不自动修复,需检查三处配置:启用自动配置或手动指定eslint.config.js路径、确保使用项目本地ESLint包、ESLint v9+须用eslint.config.js并加--flag unstable_ts_config;Prettier与ESLint冲突时,须在extends末尾引入eslint-config-prettier;保存时优先启用WebStorm原生“on save”格式化并配置Prettier引擎。

WebStorm里ESLint不报错或不自动修复?检查这三处配置
不是插件没装,而是 WebStorm 没真正“认领”你的项目级 ESLint 配置。它默认可能用全局或内置规则,导致 eslint.config.js 或 .eslintrc.js 被忽略。
- 进
Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint,勾选 “Automatic ESLint configuration”;如果无效,改选 “Manual configuration”,并在Configuration file中明确指定路径(如eslint.config.js) - 确认
ESLint package指向的是项目本地的node_modules/.bin/eslint,不是全局安装路径——尤其当你用 pnpm 或 bun 时,全局路径很可能找不到正确版本 - 若项目用 ESLint v9+,配置文件名必须是
eslint.config.js(或.cjs/.mjs),旧版.eslintrc.js不会被识别;同时需在Additional ESLint options中加--flag unstable_ts_config(即使不用 TS)
为什么Prettier格式化后ESLint又报分号/引号错误?
这是典型规则冲突:ESLint 自己还在 enforce semi、quotes 等格式规则,而 Prettier 已经按自己规则重写了代码。
- 确保已安装
eslint-config-prettier并在extends数组**最后一位**引入,例如:['eslint:recommended', 'plugin:prettier/recommended'] - 不要在
rules里手动开semi、quotes、max-len等格式类规则——这些应由 Prettier 全权控制,ESLint 只保留逻辑类规则(如no-unused-vars) - 如果用了 Vue/React 插件(如
eslint-plugin-vue),务必把plugin:prettier/recommended放在extends最末尾,否则前面的插件规则会覆盖掉禁用项
WebStorm保存时自动格式化失效?别只靠File Watcher
File Watcher 是旧方案,容易漏触发、卡 UI、不兼容新 ESLint 版本。WebStorm 2023.3+ 原生支持“on save”格式化,优先用这个。
- 进
Settings → Editor → Code Style → JavaScript,点右上角 “Configure formatting rules…”,选择Prettier作为格式化引擎 - 勾选
Run on save,并设置Scope为当前项目(避免影响 node_modules 或第三方代码) - 若仍想用 ESLint 自动修复(比如修复
no-console这类非格式问题),需额外开启:Settings → Editor → General → Save Actions → “Run eslint --fix” - 注意:二者不能同时启用“on save”修复同一类问题——比如 Prettier 处理缩进,ESLint 也试图修缩进,就会来回打架
Vue 3 / TypeScript 项目里Prettier不处理或<script setup>?</script>
默认 Prettier 不处理 Vue 单文件组件的 <template> 和 <script setup> 区域,需要显式支持。
- 安装
prettier-plugin-vue:yarn add --dev prettier-plugin-vue - 在
.prettierrc或prettier.config.js中加入:"plugins": ["prettier-plugin-vue"] - 确保
eslint-plugin-vue版本与 Vue 3 匹配(如eslint-plugin-vue@9.x),并在extends中使用plugin:vue/vue3-essential而非vue2-essential - WebStorm 的 Vue 支持需开启:
Settings → Languages & Frameworks → JavaScript → Libraries,添加vue类型库(可点Download自动获取)
eslint-config-prettier 必须压轴,plugin:prettier/recommended 必须在 extends 末尾,WebStorm 的“on save”必须指向项目级 Prettier 配置而非全局二进制。漏掉任意一环,都会退回手动修格式的老路。


















