WebStorm保存时对.vue文件不自动运行Prettier,是因为.vue被识别为独立文件类型,默认未纳入Prettier作用域;必须在Settings > Languages & Frameworks > JavaScript > Prettier中将Run for files改为{*/,*}.{js,ts,jsx,tsx,vue}并勾选On save。

WebStorm 保存时对 .vue 文件自动运行 Prettier,必须手动把 vue 加入文件匹配列表,否则它根本不会触发——不是格式化失败,是压根不执行。
为什么 .vue 文件保存时不格式化?
WebStorm 默认只对 JavaScript 和 TypeScript 类型文件启用 Prettier,.vue 被识别为独立文件类型,不在默认作用域内。即使你装了插件、写了 .prettierrc、也配置了 On Save,只要没显式添加 vue,就静默跳过。
- Settings > Languages & Frameworks > JavaScript > Prettier,找到
Run for files输入框 - 把默认值(如
{**/*,*}.{js,ts,jsx,tsx})改成{**/*,*}.{js,ts,jsx,tsx,vue} - 确保勾选
On save,而不是仅On "Reformat Code"动作 - 如果用了
pnpm,检查node_modules/.bin/prettier是否可执行;只读 store 会导致 WebStorm 找不到二进制
.prettierrc 配置不生效的三个硬性条件
WebStorm 对配置文件名和内容有严格识别逻辑,错一个就 fallback 到默认规则,比如缩进不变、单引号不转、分号还在——其实不是 Prettier 没跑,是它根本没读到你的配置。
- 优先用
.prettierrc.json(最稳),.prettierrc(无后缀)次之;prettier.config.js在部分 WebStorm 版本中被忽略 - 若用 JS 配置,必须是
module.exports = { ... },不能写export default -
.prettierignore必须放在项目根目录,且只支持扁平路径写法:src/test.js有效,src/**/test.js无效
和 ESLint 共存时的关键冲突点
Prettier 和 ESLint 规则重叠(比如 semi、quotes)会导致保存时反复拉扯:ESLint 插件加了分号 → Prettier 删掉 → 再保存又加回来。必须用 eslint-config-prettier 关闭所有格式化类规则。
立即学习“前端免费学习笔记(深入)”;
- 安装:
npm install --save-dev eslint-config-prettier eslint-plugin-prettier - 在
.eslintrc.js的extends中加入'plugin:prettier/recommended'和'eslint-config-prettier' - WebStorm 自带的 ESLint 集成要启用,Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint > Enable
- 禁用 WebStorm 原生格式化:Settings > Editor > Code Style > JavaScript > 取消勾选
Enable formatter
Vue 单文件组件里 <script></script> 和 <template></template> 的缩进行为受 vueIndentScriptAndStyle 控制,这个选项容易被忽略;不设的话,<script setup></script> 里的代码可能被错误缩进两层。


















