PhpStorm保存即格式化需在Tools → Actions on Save中勾选Reformat code，且文件类型须识别为PHP、Code Style Scheme需正确选择，缺一不可。
PhpStorm 默认不自动格式化 PHP 代码，必须同时开启「代码风格规则」和「保存时触发」两个开关，缺一不可。
怎么打开保存即格式化的开关
这个设置不在 Editor > Code Style 里，而是在 Tools > Actions on Save。很多人翻遍 Editor 设置都找不到，就是因为路径错了。
- 必须勾选
Reformat code—— 注意不是Optimize imports或Strip trailing spaces - 该选项是项目级的，新建项目要重新开启，不会继承全局配置
- 如果保存后没反应，先看右下角状态栏：显示
PHP才生效；显示Plain Text或HTML，说明文件类型识别失败 - 对
.blade.php文件，PHP 代码块默认不被识别，需右键 →Inject language or reference→ 选PHP
为什么 Ctrl+Alt+L 有时只缩进、不重排结构
这不是 bug，是 PhpStorm 按光标上下文动态决定作用域：
- 光标停在
if语句中间 → 只格式化那个if块 - 选中几行再按 → 仅格式化选区（含语法边界，比如不会把
else拆到上一行） - 光标落在
class关键字上 → 尝试格式化整个类（前提是类定义完整、无语法错误） - 想强制全文件格式化：先按
Esc清除选区，再按Ctrl+Alt+L，弹窗里选Reformat whole file
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改为对应版本 - Code Style > PHP 的 Scheme 选的是
Default，但团队用的是自定义方案 → 点右上角下拉框，选对实际生效的 Scheme，改完点Apply（仅点OK不保存部分设置）
和 php-cs-fixer 冲突怎么办
两者共存时容易互相覆盖：比如 PhpStorm 加了空格，php-cs-fixer 又删掉。
- 想统一用 php-cs-fixer：关掉 PhpStorm 内置格式器 →
Settings > Editor > Code Style > PHP > Formatter，取消勾选Enable formatter - 想保留
Ctrl+Alt+L快捷键但走外部工具：在Settings > Tools > External Tools添加 php-cs-fixer 命令，再绑定快捷键 - 如果同时启用了
On Save运行 php-cs-fixer 和 PhpStorm 格式器，大概率出现空格反复增删、括号位置抖动等问题
最易被忽略的是文件类型识别和 Scheme 选择——哪怕所有设置都对，只要右下角不是 PHP，或者 Scheme 下拉框没选对，格式化就只是“看起来开了”，实际压根不走 PHP 规则。
