WebStorm保存时自动修复ESLint问题必须配置File Watchers，因其无开箱即用的onSave开关；需设置Program为本地eslint路径、Arguments为--fix $FilePath$、Output paths to refresh为$FilePath$，并勾选Auto-save选项及启用ESLint配置加载与Code Style“Set from ESLint”。
WebStorm 保存时自动修复 ESLint 问题，必须配 File Watchers
WebStorm 没有“开箱即用”的 onSave 自动修复开关，Fix ESLint Problems 只能手动触发（右键或快捷键），想真正实现保存即修复，唯一稳定方案是用 File Watchers 绑定 eslint --fix 命令。
常见错误现象：点了 Save 文件没变、控制台无输出、修改后又回退——大概率是 watcher 没生效或路径配置错。
-
Program必须填项目本地的 ESLint 二进制路径：$ProjectFileDir$/node_modules/.bin/eslint（Windows 下可能是.cmd后缀） -
Arguments推荐只修当前文件：--fix $FilePath$；避免用--fix .或--fix src/，否则可能误改未编辑文件 -
Output paths to refresh必须设为$FilePath$，否则 WebStorm 不会重载变更内容，看起来像没修 - 务必勾选
Auto-save edited files to trigger watcher和Trigger the watcher on external changes
ESLint 配置加载失败，90% 是配置文件名或 flag 问题
WebStorm 识别不了 eslint.config.js（v9+ 扁平配置），就会 fallback 到报错或静默失效，右键菜单里根本不出 Fix ESLint Problems 选项。
使用 eslint.config.js 或 eslint.config.ts 的项目（2025 年起主流），必须在 Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint 的 Extra ESLint options 里加：--flag unstable_ts_config。
- 老项目用
.eslintrc.js或.eslintrc.cjs，直接选 “Automatic ESLint configuration” 即可 - 若手动指定配置文件，路径必须精确匹配，比如
.eslintrc.cjs写成.eslintrc.js就会加载失败 - ESLint 包必须装在项目本地
node_modules中，全局安装无效
格式化结果不一致？先关掉 WebStorm 自带代码风格
即使 eslint --fix 成功运行，代码缩进、引号、分号等仍可能被 WebStorm 自己的格式规则覆盖，导致“修了又乱”。
关键动作不是配快捷键，而是把 WebStorm 的格式化源头切到 ESLint：Settings > Editor > Code Style > JavaScript > Set from… → 选 ESLint。
- 这个设置决定“修成什么样”，比快捷键优先级高得多
- 如果同时启用 Prettier，建议禁用它的 onSave 格式化，或统一用
eslint-plugin-prettier把 Prettier 当 ESLint 规则跑 - Vue / TypeScript 项目需确认
parser和parserOptions在 ESLint 配置中已正确定义，否则Set from ESLint会灰掉
Vue / TS 文件修复失败，检查 parser 和 plugin 是否启用
对 .vue 或 .ts 文件右键没有 Fix ESLint Problems，通常不是 WebStorm 问题，而是 ESLint 配置里缺对应解析器或插件。
比如 Vue 单文件组件需要 eslint-plugin-vue 和 parser: 'vue-eslint-parser'（v9+ 可能需额外配置），TypeScript 需 @typescript-eslint/parser 和 eslint-plugin-typescript。
- 确保
plugins数组包含'vue'或'@typescript-eslint'，且extends中对应规则集（如plugin:vue/vue3-essential）已正确引入 - WebStorm v2025.3 支持
eslint.config.ts，但更早版本只认.js或.cjs - 如果用
eslint-plugin-prettier，注意它必须放在extends数组最后，否则会被其他规则覆盖
最易被忽略的是：File Watchers 配好后，$FilePath$ 传参是否带空格或特殊字符（比如路径含中文），这会导致命令直接退出且无提示。真遇到“点了保存但没反应”，先在 Terminal 手动执行一遍 npx eslint --fix path/to/your/file.js 看是否报错。
