WebStorm 中 Prettier 按项目绑定本地 package 路径，需在 Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier 的 Package 字段指向当前项目 node_modules/prettier/index.js；多根工作区须为每个子模块单独配置，留空该字段可触发自动发现机制，配合 .prettierrc.json 实现团队统一格式化。
WebStorm 里 Prettier 插件不是“切换”，而是按项目绑定 package 路径
WebStorm 不支持像 VS Code 那样在 UI 里点一下就切到另一个 prettier 版本——它靠的是 Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier 中的 Package 字段指向哪个 prettier 可执行文件。这个路径一旦设错，整个项目就用不上你装的本地版本。
常见错误现象：同一台机器上多个项目，A 项目格式化正常，B 项目 Ctrl+Alt+L 后缩进还是 4 格、分号还在，大概率是 B 项目的 Package 路径没指向自己 node_modules/prettier，而是误用了全局或别的项目的路径。
- 打开
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier - 检查
Package输入框内容：必须是类似$ProjectFileDir$/node_modules/prettier或绝对路径到当前项目下的prettier/index.js - 别直接粘贴全局路径（如
/usr/local/lib/node_modules/prettier），不同项目依赖的 prettier 版本可能不兼容（比如 v3.0 不支持vueIndentScriptAndStyle） - 如果用 pnpm，路径可能是
$ProjectFileDir$/node_modules/.pnpm/prettier@3.3.3/node_modules/prettier，建议点击右侧...按钮手动选中node_modules/prettier目录下的index.js文件
多根工作区（Multi-root Workspace）下每个子项目要单独配 Prettier 路径
Monorepo 项目（如用 Turborepo / Nx / Rush）常有多个子包共存于一个 WebStorm 窗口。WebStorm 不会自动为每个子目录推导独立的 prettier 路径——它只认当前「Project」设置里的那个 Package 值。
结果就是：你改了 packages/ui 的代码，但格式化行为却走的是 packages/api 下的 prettier 配置，甚至报错说找不到 .prettierrc.json（因为实际去 api 目录下找了）。
- 确认当前子项目是否被识别为独立 module：右键项目根目录 →
Open Module Settings→ 看Modules列表里有没有对应子包名 - 对每个子模块，单独打开
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier，重设Package路径 - 不要依赖 “Inherit project settings” —— 这个选项在多根场景下经常失效
- 验证方式：在子包内任意 .ts 文件按 Ctrl+Alt+L，然后立刻看右下角状态栏是否闪出 “Reformatted with Prettier” 提示
为什么改了 Package 路径还不生效？检查这三处缓存和作用域
改完路径后仍不格式化，不是配置失败，而是 WebStorm 没刷新上下文。它会缓存文件类型绑定、格式器选择、甚至 Node.js 解析器路径，导致新路径被忽略。
- 重启 WebStorm（不是 Reload Project）：这是最稳的清缓存方式；部分版本 Reload 后
Prettiertab 里的设置会回退 - 确认文件类型正确：右下角状态栏显示的是
TypeScript还是Plain Text？如果是后者，右键文件 →Override File Type→ 选TypeScript - 检查
Settings > Editor > Code Style > TypeScript > Formatter下拉菜单是否真选了Prettier（不是IDE Default）——这是真正接管快捷键的开关，和上面的Package设置是两回事
团队协作时怎么避免每个人手动配路径？用 .prettierrc.json + 本地安装就够了
手动配 Package 路径没法提交到 Git，每次换人开项目都要重来一遍。真正可复现的方式，是让 WebStorm 自动发现本地 prettier 并读取配置文件。
- 确保项目根目录有
package.json且含"prettier": "^3.3.3"（或对应版本） - 执行
npm install或pnpm install，让node_modules/prettier真实存在 - 放一个
.prettierrc.json在项目根目录（不是prettier.config.js，JS 格式在某些 WebStorm 版本里不被识别） - 删掉
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier > Package里的自定义路径，留空——WebStorm 会自动 fallback 到$ProjectFileDir$/node_modules/prettier
这个组合下，只要 node_modules 存在，WebStorm 就能加载正确版本和规则；而 .prettierrc.json 是唯一需要团队统一维护的文件，比 IDE 设置靠谱得多。
