WebStorm保存时自动格式化没反应，根本原因是Reformat code未生效或ESLint/Prettier规则未对齐：需检查Only if file is physically modified是否误勾、当前文件类型是否绑定对应格式化器、文件是否被识别为正确语言；ESLint规则须通过Set from ESLint显式绑定；File Watcher调用eslint --fix时需确保Program路径、Arguments为--fix $FilePath$、Output paths设为$FilePath$并启用自动触发。
WebStorm 保存时自动格式化没反应，基本就是 Reformat code 开关没真正生效，或者它和 ESLint / Prettier 的规则源头没对齐——不是插件没装，而是配置链断在了某个环节。
Reformat code 勾了但没触发？检查这三项
很多人点开 Settings > Tools > Actions on Save 勾了 Reformat code，一按 Ctrl+S 还是原样不动。常见卡点：
-
Only if file is physically modified被误勾：WebStorm 会跳过“看起来没改”的文件（比如只改了注释、空格），导致格式化不执行 - 当前文件类型没绑定格式化器：.vue 文件的
<script>块默认走 JavaScript 设置，但<template>是 HTML 类型，需单独在Editor > Code Style > HTML中确认是否启用格式化 - 文件未被识别为对应语言：右下角状态栏看当前文件类型是不是
JavaScript或TypeScript；如果是Text或Plain Text，右键 →Override File Type→ 选对语言
ESLint 规则没落地到格式化？Set from ESLint 必须做
即使 ESLint 插件已启用、报错能显示，Ctrl+Alt+L 或保存格式化仍可能无视 ESLint 规则——因为 WebStorm 默认用的是内置 JS 格式化引擎，和 ESLint 无关。
- 必须进
Settings > Editor > Code Style > JavaScript（或TypeScript/Vue.js），点右上角齿轮 →Set from…→ 选ESLint - 前提：ESLint 已正确加载（
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint显示绿色对勾） - v9+ 扁平配置（
eslint.config.js）需在Extra ESLint options填--flag unstable_ts_config，否则Set from ESLint会静默失败 - 若项目同时用 Prettier，禁用所有与格式相关的 ESLint 规则（如
quotes、semi），只留prettier/prettier: "error"，避免冲突
File Watcher 配 eslint --fix 总是不运行？路径和刷新逻辑最易错
这是目前唯一能稳定实现“保存即修复”的方案，但配置稍有偏差就会静默失效：
-
Program必须填项目本地路径：$ProjectFileDir$/node_modules/.bin/eslint（macOS/Linux）或$ProjectFileDir$/node_modules/.bin/eslint.cmd（Windows） -
Arguments推荐固定写--fix $FilePath$：只修当前文件，避免--fix .意外扫到其他文件 -
Output paths to refresh必须设为$FilePath$：否则 WebStorm 不知道文件已被修改，不会重载内容，看起来像“没修” - 务必勾选
Auto-save edited files to trigger watcher和Trigger the watcher on external change，缺一不可
格式化后立刻又报错？说明工具在互相覆盖
修复完 ESLint 报错，紧接着又出现缩进/引号/分号类新报错，不是配置漏了，而是多个格式化源在打架：
- 别同时开启
Actions on Save里的Reformat code和Fix ESLint Problems（WebStorm 不原生支持后者） - 如果用了 File Watcher 跑
eslint --fix，就不要再把 Prettier 设为默认格式化器，二者规则不兼容 - WebStorm 的
Editor > Code Style面板里，所有格式相关项（Use tabs、Semicolons、Quote style）应清空或设为“Use configured code style”，让 ESLint 或 Prettier 配置文件全权控制 - 团队协作时，
.eslintrc.js或.prettierrc必须提交 Git，IDE 设置（如.idea/下文件）禁止提交
真正容易被忽略的是：WebStorm 不会自动把 ESLint 配置“翻译”成格式化行为，Set from ESLint 和 File Watcher 是两套独立机制，一个管快捷键和手动格式化，一个管保存动作——想无缝，就得都配，且确保它们指向同一份规则源。
