webstorm中prettier不生效需先设为默认格式化工具：在code style中set from prettier，并在actions on save中勾选reformat code且取消“only if code style errors detected”；配置文件须置于项目根目录，命名与导出格式需正确，多根工作区需各子项目单独配置。
WebStorm 里 Prettier 不生效？先确认它真被设为默认格式化工具
很多人点了“Reformat Code”没反应，或只格式化了一半——根本原因是 WebStorm 默认用的是内置格式器，Prettier 只是装上了，没“扶正”。必须手动指定它接管 JavaScript/TypeScript/JSON 等文件的格式化行为。
- 进
Settings > Editor > Code Style > JavaScript（或TypeScript），点右上角齿轮 →Set from... > Prettier - 更关键的是：打开
Settings > Tools > Actions on Save，勾选Reformat code，并确保下方Only if code style errors detected没被误勾（否则无报错就不格式化） - 如果项目根目录有
.prettierrc或prettier.config.js，WebStorm 会自动读取；但若配置项和 WebStorm 内置风格冲突（比如缩进用tab而配置写2），优先以 Prettier 配置为准——别在 WebStorm 的Code Style里调缩进，那只是摆设
“Format on Save” 失效的典型场景和绕过方式
不是所有保存都会触发 Prettier。常见失效点：文件没被识别为对应语言类型、保存时编辑器焦点不在代码区、或者用了 Ctrl+S 但没开启对应动作。
- 检查右下角状态栏：文件名后应显示
JavaScript/TypeScript/JSON。如果显示Text或Plain Text，右键文件 →Override File Type→ 选对类型 -
Actions on Save只对当前编辑的文件生效，不作用于批量保存（比如Ctrl+Shift+S全局保存） - 如果只想对某些文件启用（比如跳过
node_modules或生成的.d.ts），在Settings > Tools > File Watchers里删掉无关 watcher，或在Prettier插件设置中加excluded files：填**/node_modules/**,**/*.d.ts
Prettier 和 ESLint 冲突时谁说了算？
ESLint 的 prettier/prettier 规则报错，不代表 Prettier 没运行——恰恰说明它跑了，但结果和 ESLint 期望不一致。这时候不是关掉 ESLint，而是让 ESLint “闭嘴”，只做逻辑检查。
- 在
eslintrc.js或.eslintrc.cjs中，确保已禁用所有和格式相关的规则："prettier/prettier": "off"，同时保留"eslint-config-prettier"在 extends 最后一项 - WebStorm 的 ESLint 设置（
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint）里，勾选Run for files，但**不要**勾选Fix problems automatically on the fly——这个功能会用 ESLint 自己的修复逻辑覆盖 Prettier 结果 - 如果仍看到红色波浪线提示格式错误，重启 WebStorm 或执行
File > Invalidate Caches and Restart，缓存常导致规则未热更新
为什么 .prettierrc 里的配置有时像没读取？
WebStorm 对配置文件的加载路径很严格：它只认项目根目录下的 .prettierrc、prettier.config.js、package.json 里的 prettier 字段。子目录或符号链接里的配置会被忽略。
- 检查文件名是否拼错：
.prettierrc.json✅，.prettierrc.js✅，但prettier.config.json❌（WebStorm 不识别） - 如果用
prettier.config.js，导出必须是 CommonJS：module.exports = { semi: false };，ESM（export default）不支持 - 配置里写了
"tabWidth": 4却还是 2 格？看有没有被editorconfig覆盖——WebStorm 会优先读取.editorconfig中的indent_size，删掉或注释掉那行即可
最麻烦的其实是多根工作区（multi-root workspace）：每个子项目得各自配好 .prettierrc，WebStorm 不会向上查找父级配置。这点很容易漏，改完主项目配置发现子项目依旧不生效，就是卡在这儿了。
