团队必须统一由 PHP-CS-Fixer 负责格式化，禁用 PhpStorm 自动格式化以避免冲突；需导出并共享 phpstorm-code-style.xml 配置文件，明确规则修改权限与同步机制。
直接说结论：团队统一编码风格，不能只靠 PhpStorm 内置格式化规则，必须明确「谁负责格式化」——是 PhpStorm 还是 PHP-CS-Fixer？两者混用必翻车。
为什么改了 Settings → Code Style → PHP 却没生效
常见现象：调完 Braces placement、Spaces within parentheses，按 Ctrl+Alt+L 格式化，结果和预期不一致，甚至被 Git 提交时自动“打回”。
- 当前文件绑定了别的 Scheme（右上角
Scheme下拉菜单不是你改的那个） - 点了
OK没点Apply—— 部分设置（如 Wrapping 页的选项）只在Apply后才写入 - 项目根目录启用了
Use per-project settings，但你改的是 Global Scheme - 文件实际类型识别错误：右下角显示不是
PHP，而是Text或HTML，格式化逻辑完全不触发
PSR-12 在 PhpStorm 里怎么配才不和 PHP-CS-Fixer 冲突
关键矛盾点在于：PhpStorm 默认把 { 放在 if 同一行（K&R），而 PSR-12 要求独占一行（Allman）。若两边都开自动格式化，会反复拉扯。
-
Braces placement→ 设为Next line（不是Next line if wrapped） -
Spaces within parentheses→ 关闭（否则foo($a)可能变成foo( $a )） -
trait use statement→ 进Wrapping and Braces页，设为Do not wrap，并取消勾选Sort use statements - 数组对齐：
Array initializer → Align when multiline建议关掉，PHP-CS-Fixer 的array_syntax规则不认这个对齐 - 如果团队已用
php-cs-fixer，PhpStorm 里只配基础缩进（Tab size = 4，Indent = 4）和换行宽度（Right margin = 120），其余交给外部工具
如何让格式化真正落地到每个成员的编辑器里
光配好自己机器没用。团队要一致，得靠可版本化的配置文件。
立即学习“PHP免费学习笔记（深入）”；
- 导出配置：
Editor → Code Style → PHP → Manage… → Export Scheme…，保存为phpstorm-code-style.xml - 把这个 XML 文件放进项目根目录，加进
.gitignore以外的位置（比如.phpstorm/），并在 README 里写明“导入路径” - 新人打开项目后，进
Settings → Editor → Code Style → PHP → Manage… → Import Scheme…，选该文件 - 更稳妥的做法：禁用 PhpStorm 的格式化快捷键，强制所有人用
php-cs-fixer fix --rules=@PSR12 src/提交前校验，IDE 只负责语法高亮和跳转 - 注意：XML 导出不包含
File Encodings设置，UTF-8 编码必须单独在Editor → File Encodings中设Project Encoding = UTF-8并提交.idea/encodings.xml
保存即格式化，但别让 Ctrl+S 变成焦虑源
启用 Format on Save 很方便，但容易掩盖真实问题。
- 路径：
Settings → Editor → General → Save Actions → Format on save - 务必勾选
Only changed lines，否则每次保存都重排整个文件，Git diff 全是空格变动 - 如果同时启用了 PHP-CS-Fixer 的
Run on save，两个工具会竞争执行顺序，导致格式化不完整或报错 - 推荐做法：关掉 IDE 的
Format on Save，改用File Watchers或 Git hook（如pre-commit）统一跑php-cs-fixer，失败则阻断提交 - 特别注意：
php-cs-fixer的配置文件（.php-cs-fixer.php）必须和团队共享，且规则集明确写死，比如'@PSR12' + ['array_syntax' => 'short']
最常被忽略的一点：格式化规则只是表层，真正卡住团队协作的是「谁有权限改规则」和「改了之后怎么同步」。XML 文件放在哪、是否纳入 CI 检查、有没有 pre-commit 把关——这些比括号放哪一行重要得多。
