必须手动应用PSR-12模板并校准关键参数：进入Settings → Editor → Code Style → PHP，点击Set from→PSR-12，Braces placement设为Next line，Spaces within parentheses取消勾选，After keyword下if/for/function等均需勾选，且需同步配置PHP-CS-Fixer路径与规则文件。
PhpStorm 默认不应用任何代码格式化规范，必须手动拉取 PSR-12 模板并校准关键参数，否则 Ctrl+Alt+L 格式出来的代码大概率和团队 CI 报错的风格不一致。
怎么快速启用 PSR-12 风格模板
别从零调参数，先用预设再微调：
- 打开
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 默认值和标准冲突，改完模板后仍需检查：
立即学习“PHP免费学习笔记（深入）”；
-
Braces placement → Brace position for control statements / functions：必须设为Next line，否则if ($x) {会被格式化成 K&R 风格，违反 PSR-12 要求 -
Spaces → Within parentheses：必须取消勾选，否则foo($bar)会被塞成foo( $bar )，违反“括号内不加空格”规则 -
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却不指定标准
保存即格式化开关在哪，为什么开了没反应
这个功能藏在 Tools → Actions on Save 里，不是 Editor > Code Style —— 很多人翻遍 Editor 设置都找不到，就是因为路径错了：
- 必须勾选
Reformat code—— 注意不是Optimize imports或Strip trailing spaces - 该选项是项目级的，新建项目要重新开启，不会继承全局配置
- 如果保存后没反应，先看右下角状态栏：显示
PHP才生效；显示Plain Text或HTML，说明文件类型识别失败 - 对
.blade.php文件，PHP 代码块默认不被识别，需右键 →Inject language or reference→ 选PHP
真正起效的从来不是“有没有开开关”，而是文件是否被识别为 PHP、Code Style Scheme 是否选对、以及有没有被 .editorconfig 覆盖 —— 这三者缺一不可。
