大多数保存失效问题源于格式化工具冲突或未正确启用“保存时操作”，统一格式化工具并检查触发开关通常能解决。
先说结论：WebStorm 保存时不格式化通常是因为“保存时操作”未勾选、Prettier/ESLint 配置冲突或快捷键被占用，需统一工具链并确认触发条件。
- 先确认：检查 Settings → Tools → Actions on Save 中是否启用了 Reformat code 或 Run eslint `--fix`（WebStorm 2020.3+ 支持）。
- 先处理：若使用 Prettier，需在 Code Style 中指定 Package 路径并勾选 On save；若用 ESLint，确保配置了 File Watchers 或内置修复。
- 再验证：保存文件后观察代码缩进变化，并确认控制台无格式化冲突报错。
版本与环境确认
不同版本 WebStorm 配置路径略有差异，请先确认 IDE 版本：
- Actions on Save：仅 WebStorm 2020.3 及以上版本支持该功能面板。
- Prettier 支持：2021.1 及以上版本内置 Prettier 支持，无需单独安装插件；旧版本需在 Plugins 市场安装 Prettier - Code formatter。
- 操作系统：Windows/Linux 快捷键通常为 Ctrl+Alt+L，macOS 为 Option+Command+L。
常见报错日志解析
标题提及“报错”，若保存时未格式化且伴随以下日志，请针对性修复：
- Prettier package not found：表示未指定 Prettier 包路径。解决：进入 Languages & Frameworks → JavaScript → Prettier，手动选择项目内的 node_modules/prettier。
- ESLint configuration file not found：表示项目根目录缺少 .eslintrc 配置。解决：初始化 ESLint 配置或指定配置路径。
- Event Log 静默无反应：通常表示“保存时操作”未勾选，或文件被识别为纯文本（Plain Text）。
分步配置与修复
1. 启用保存时自动操作
进入 Settings → Tools → Actions on Save（2020.3+），根据需求勾选：
- 若仅需格式化：勾选 Reformat code。
- 若需修复 ESLint 错误：勾选 Run eslint `--fix`（二者选其一，避免冲突）。
注意：部分旧版本需在 Editor → General → Save Actions 中查找相关选项。
2. 配置 Prettier 自动格式化
若项目使用 Prettier，需确保 IDE 识别正确：
- 新版 IDE：直接进入 Languages & Frameworks → JavaScript → Prettier，无需安装插件。
- 旧版 IDE：在 Plugins 中搜索并启用 Prettier - Code formatter。
- 指定路径：设置 Prettier package 为项目内的
node_modules/prettier或全局路径。 - 启用触发：勾选 Run on save 和 On code reformatting。
3. 排查快捷键冲突
若手动按格式化快捷键无反应：
- 检查占用：临时退出 QQ、网易云音乐等常驻软件，测试是否恢复。
- 重置映射：进入 Settings → Keymap，搜索 Reformat Code，确认快捷键未被标记为冲突或灰色不可用。
4. 确认文件类型关联
针对.vue 或特殊后缀文件：
- 进入 Settings → Editor → File Types。
- 确认.vue 文件关联到 Vue.js Template 或对应语言类型。
- 检查右下角状态栏，确保文件被识别为 JavaScript/TypeScript 而非 Text。
怎么验证是否生效
- 观察代码变化：故意打乱一段代码缩进或引号，保存后查看是否自动恢复整齐。
- 检查 ESLint 报红：保存后若 ESLint 波浪线消失，说明自动修复已生效。
- 查看日志：若配置了 File Watchers，可在底部工具窗口查看 watcher 触发记录。
常见坑
- ESLint 与 Prettier 打架：若同时启用，建议在 ESLint 配置中引入
eslint-config-prettier关闭冲突规则，或仅保留一种工具负责格式化。 - EditorConfig 覆盖：项目根目录的
.editorconfig优先级可能高于 IDE 设置，若缩进异常，检查该文件配置。 - 只读文件限制：若文件处于只读状态或 Git 冲突标记中，WebStorm 会静默跳过格式化。
- Safe Write 干扰：启用“Safe Write”功能时，保存机制可能影响格式化触发，可尝试禁用测试。
更多详细配置可参考 JetBrains 官方文档关于 Code Style 与 File Watchers 的说明。
原文链接：https://www.zjcp.cc/ask/11722.html