PhpStorm需手动开启On Save的Run code formatter才能自动格式化PHP代码；Blade中PHP代码须手动注入PHP语言支持。
PHP代码自动格式化在哪开启
phpstorm 默认不会自动格式化 php 代码，必须手动启用「on save」或「on type」触发机制。不打开这个开关，按 ctrl+alt+l（windows/linux）或 cmd+option+l（macos）只能手动格式化，无法做到“保存即整理”。
- 进入
Settings > Editor > Code Style > PHP，确认缩进、空格、大括号位置等规则已按团队/PSR-12 调整好 - 再去
Settings > Editor > General > On Save，勾选Run code formatter（不是“Optimize imports”或“Strip trailing spaces”） - 如果只想在键入时局部生效（比如输入
{自动补全并换行），需额外开启Settings > Editor > General > Smart Keys > PHP > Insert pair bracket和Auto-indent on paste
常见错误现象：改了 Code Style 却没生效，其实是忘了在 On Save 里启用格式器；或者开了 On Save 却发现某些文件没反应——检查右下角状态栏是否显示 PHP 语言模式，非 PHP 文件（如 .inc 或无后缀模板）可能被识别为 Plain Text，格式化规则不加载。
为什么 Ctrl+Alt+L 有时只缩进不重排
这不是 bug，是 PhpStorm 尊重你当前的「作用域选择」：如果光标在函数内、或选中了一段代码块，Ctrl+Alt+L 默认只格式化选区；全文件格式化需要确保没有文本被选中，且光标在编辑区任意位置（非行首/行尾特殊位置）。
- 没选中文本 → 格式化整个文件
- 选中某几行 → 只格式化这几行（含语法结构上下文，比如不会把
if拆到上一行） - 光标停在
class关键字上 → 按一次Ctrl+Alt+L会尝试格式化整个类（前提是类定义完整、无语法错误）
性能影响：大文件（>2000 行）全量格式化可能卡顿 1–2 秒，尤其启用了 PSR-12 的「strict」模式（如强制单行 return、严格空行规则）。可临时切换到「PHP Built-in」风格做快速对齐，再切回 PSR-12 补细节。
PSR-12 格式化失效的三个典型原因
PSR-12 规则依赖准确的语法解析，一旦代码存在低级语法问题，格式化引擎会降级为“安全模式”，只做基础缩进，跳过换行、空格、括号对齐等高级操作。
立即学习“PHP免费学习笔记（深入）”；
- 文件顶部有 BOM 字节（尤其 Windows 编辑器保存的 UTF-8 文件），导致解析器误判文件头，
Settings > Editor > File Encodings中勾选Transparent native-to-ascii conversion并重开文件 - 使用了 PHP 8.2+ 新语法（如
readonly class），但项目 SDK 设置仍是 PHP 7.4 → 进入Project Settings > PHP > Language level改为对应版本 - 类中混用短数组语法
[]和长数组语法array()，而 PSR-12 要求统一。格式化器遇到不一致时会放弃重排数组项，只保留原始缩进
容易踩的坑：直接从 GitHub 粘贴代码进 PhpStorm，有时带不可见控制字符（如 \u200b 零宽空格），表面看正常，实则阻断语法树构建。用 View > Active Editor > Show Whitespaces（快捷键 Ctrl+Shift+8）能快速暴露。
如何让 Blade 模板里的 PHP 代码也被格式化
Blade 文件（.blade.php）默认只格式化 HTML 部分，PHP 代码块（@if、<?php）不参与 PHP Code Style 规则。必须显式告诉 PhpStorm：“这部分是 PHP”。
- 打开
Settings > Editor > File Types，找到Laravel Blade template类型 - 在
Registered Patterns下确认*.blade.php已关联 - 点击下方
Inject language or reference区域，添加新注入：选择PHP，Pattern 填@(if|elseif|else|endif|foreach|endforeach|for|endfor|while|endwhile|php|endphp) - 更彻底的做法：在 Blade 文件里，把光标放在 PHP 块内，按
Alt+Enter→Inject language or reference→ 选PHP
注意：注入后，@{{ $var }} 这类 Vue-style 插值不会被当 PHP 解析，这是预期行为；真正要格式化的，是 @php ... @endphp 或 <?php ... ?> 块。别指望它给 @section('content') 加空行——那属于 Blade 语法，不在 PHP 格式化范围内。
事情说清了就结束。最常被忽略的是：格式化开关藏在 On Save 里，而不是 Code Style 页；以及 Blade 中 PHP 块默认不参与规则，得手动注入。
