WebStorm项目格式化需.editorconfig（根目录，基础层）+语言级Code Style（本地生效）+Prettier绑定（手动设置）三层协同；改Settings无反应因Code Style不写入项目，.editorconfig才跨编辑器统一。
WebStorm 项目特定的格式化规则不是“设一次就全局生效”，而是靠 .editorconfig + 语言级 Code Style 设置 + 工具绑定（如 Prettier）三层叠加，且优先级明确：项目根目录的 .editorconfig 是唯一能跨编辑器、跨成员强制统一的基础层。
为什么改了 Settings > Editor > Code Style 没反应？
常见现象是：你在 Settings > Editor > Code Style > TypeScript 里调好了箭头函数缩进，保存文件却还是老样子。根本原因不是设置没保存，而是 WebStorm 默认不把本地 Code Style 当作“项目专属规则”——它只影响你当前 IDE 的行为，不写入项目、不随 Git 提交、队友打开项目时完全不感知。
- 手动格式化（
Ctrl+Alt+L/Cmd+Option+L）走的是当前 Code Style 配置，但仅限你本机 - 保存时自动格式化（
Reformat code on save）是否触发，取决于该文件类型是否被显式绑定到某个格式化器（比如 Prettier），而不是 Code Style 页面开了什么开关 -
.editorconfig文件必须放在项目**根目录**，且文件名严格为.editorconfig（开头带点，全小写），否则 WebStorm 不识别
如何让 .editorconfig 真正接管基础格式？
.editorconfig 只管通用项，不碰语言细节。它起作用的前提很硬：文件存在、位置正确、内容语法合法、WebStorm 没被禁用该功能（默认开启）。
- 确认项目根目录有
.editorconfig，内容类似：[*]\nindent_style = space\nindent_size = 2\nend_of_line = lf\ntrim_trailing_whitespace = true\ninsert_final_newline = true
- 它对
indent_size、end_of_line这类项生效，但不会决定if (x) {的括号要不要换行——那是Code Style > JavaScript或 Prettier 的事 - 如果项目里同时有
.prettierrc和.editorconfig，Prettier 会读取自己的配置为主，.editorconfig中与之重叠的项（如indent_size）可能被忽略，除非 Prettier 显式配置了useTabs: false等对应字段
怎么把 Prettier 绑定到具体文件类型？
很多人以为装了 Prettier 插件、项目里有 prettier.config.js 就万事大吉，结果 .vue 或 .ts 文件按快捷键毫无反应——因为 WebStorm 默认仍用内置 JS/TS 格式化器，Prettier 是“备选工具”，不是“默认引擎”。
- 必须进
Settings > Editor > Code Style > JavaScript，在右上角齿轮菜单点Set from → Prettier；同理，TypeScript、Vue、HTML页签也得各自点一遍 - 检查
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier中的Package路径，必须指向项目内node_modules/prettier，不能是全局安装路径 -
<template></template>块属于 HTML，Prettier 默认不处理；若需格式化，得额外装prettier-plugin-vue并在 Prettier 设置里填插件路径
团队共享配置时最容易漏掉的三件事
导出 codeStyleSettings.xml 或共享 .editorconfig 很容易，但真正落地时，90% 的协作问题出在边界条件没对齐。
- ESLint 和 Prettier 同时启用
on save：WebStorm 不会自动协调二者顺序，大概率导致格式化后立刻报 ESLint 错误，再修复又破坏格式，形成循环。解法是只开一个：要么纯 Prettier 格式化，要么用 ESLint 的eslint-config-prettier关闭所有格式规则，只留代码质量检查 -
.editorconfig里写了charset = utf-8，但某些旧版 WebStorm（2022.1 之前）对 BOM 处理异常，Windows 下可能读成乱码，建议所有文本文件统一存为 UTF-8 without BOM - 多人共用同一份
codeStyleSettings.xml，但有人用 Windows、有人用 macOS，end_of_line在 XML 里写死为lf，Windows 用户保存时可能被系统悄悄转成crlf，Git 提交后引发换行符冲突——此时应依赖.editorconfig的end_of_line = lf，而非 XML 配置
