必须手动应用PSR-12模板并校准关键细节：进入Settings → Editor → Code Style → PHP，点击Set from→PSR-12，勾选After keyword空格规则，Braces placement设为Next line，Spaces within parentheses取消勾选，并确保Scheme选Project且配好PHP-CS-Fixer。
PhpStorm 本身不默认启用任何 PSR 标准，必须手动应用 PSR-12 模板并校准关键细节，否则 Ctrl+Alt+L 格式化出来的代码大概率和团队要求不一致。
怎么快速启用 PSR-12 风格模板
PSR-12 是当前 PHP 社区主流标准，PhpStorm 内置支持但不默认激活。别从零调参数，先拉预设再微调：
- 打开
Settings / Preferences → Editor → Code Style → PHP - 点击右上角
Set from…按钮 - 选择
Predefined style → PSR-12（不是 PSR-2，它已废弃） - 务必点击
Apply—— 仅点OK不会保存括号位置、空格等关键项
此时预览区会显示符合 PSR-12 的示例代码，但注意：这只是编辑器级格式化骨架，不等于 PHP-CS-Fixer 或 phpcs 的完整规则。
Braces placement 和 Spaces within parentheses 必须手动核对
这两个设置是 PSR-12 最常翻车的点，PhpStorm 默认值和 PSR-12 冲突，改完模板后仍需检查：
立即学习“PHP免费学习笔记（深入）”；
-
Braces placement → Brace position for control statements / functions：必须设为Next line（即 Allman 风格），否则if ($x) {会被格式化成 K&R 风格，和 PSR-12 要求的独占一行不符 -
Spaces → Within parentheses：必须 取消勾选，否则foo($bar)会被塞成foo( $bar )，违反 PSR-12 的“括号内不加空格”规则 -
Spaces → After keyword下的if、for、function等都要勾选，确保if ($x)中关键字后有空格
为什么改了 PSR-12 还被 PHP-CS-Fixer 打回
因为 PhpStorm 的 Code Style 和外部工具（如 php-cs-fixer 或 phpcs）是两套独立系统。只配编辑器，不配工具，就永远在“格式化 → 提交 → CI 报错 → 修复 → 再提交”的循环里：
- 确认项目根目录有
.php-cs-fixer.php或phpcs.xml，且内容明确包含@PSR12或<rule ref="PSR12"></rule> - 在
Settings → Languages & Frameworks → PHP → Code Sniffer中，Path to phpcs必须指向真实可执行文件（如vendor/bin/phpcs），不能留空或填错路径 - 在
Settings → Editor → Inspections → PHP → PHP Code Sniffer validation中，Coding standard必须选Custom并指向你的phpcs.xml，不能只勾选 Enable 却不指定标准 - 如果用
php-cs-fixer，建议在Tools → External Tools里配置它为快捷命令，并绑定到Ctrl+Shift+Alt+F类快捷键，编辑器格式化只做基础对齐，重活交给它
项目级 Scheme 和文件类型覆盖容易被忽略
多人协作时，最隐蔽的问题是：你以为全项目统一了，其实只有部分文件生效：
- 检查右上角
Scheme下拉框是否选中Project（而非Default），否则改的是全局设置，对当前项目无效 - Blade、Twig、PHP 文件可能需要不同风格：在
Editor → Code Style页面点+ Add，为Blade Template单独选 HTML 风格，避免 PHP 规则误作用于模板语法 - 团队共享配置时，导出的是
phpstyle.xml（通过Manage… → Export），不是phpcs.xml；前者控制编辑器格式化，后者控制静态分析，二者不可互换
PSR-12 的真正落地，从来不是点几下菜单的事——它依赖编辑器规则、本地检测工具、项目配置文件三者对齐。少一个，格式化就只是表面功夫。
