PhpStorm 的 PHP 代码格式化规则在 Editor → Code Style → PHP 中设置，需确认 Scheme 正确、点击 Apply，并建议基于 PSR-12 预设微调；注意 Braces placement、Spaces within parentheses 等关键项以避免与 PHP-CS-Fixer 冲突。
在哪里改 PHP 代码格式化规则
PhpStorm 的代码风格设置不在“Editor → General”里，而是在 Editor → Code Style → PHP。点进去后别急着调参数，先确认右上角的 Scheme 是你正在用的（比如 Default 或项目专属的 Project），否则改了也不生效。
常见错误：改完 Settings → Editor → Code Style → PHP 却发现格式化没变化——大概率是当前文件绑定了别的 Scheme，或者没点 Apply（仅 OK 不会保存部分设置）。
- 项目级规则优先于全局，建议在项目根目录下启用
Use per-project settings - 改完记得点
Set from...选一个预设（比如PSR-12）再微调，比从零配更稳 - 如果团队用 PHP-CS-Fixer，这里只管基础缩进/空格，具体规则交给外部工具，别重复控制
缩进、空格和括号怎么不踩坑
PHP 里最常翻车的是 if 和 function 后的空格、大括号换行逻辑。PhpStorm 默认用 K&R 风格（左大括号换行），但 PSR-12 要求 Allman 风格（左大括号独占一行），这两者冲突会导致格式化后被 PHP-CS-Fixer 反复打回。
-
Braces placement设为Next line（对应 PSR-12） -
Spaces within parentheses关掉，否则foo( $bar )会被塞空格 -
Method call chain勾选Wrap always，避免长链式调用挤成一行 - 注意
Array initializer下的Align when multiline：开启后多维数组对齐好看，但和某些 linter 冲突，建议关
为什么格式化后 trait use 语句乱了
这是 PhpStorm 2022.3+ 的已知行为：use 语句在类中默认按字母排序，且会把 insteadof 和 as 拆到新行。如果你的代码里写了 use A, B { B::foo as bar; }，格式化可能变成三行，破坏可读性。
立即学习“PHP免费学习笔记（深入）”；
- 进
Editor → Code Style → PHP → Wrapping and Braces - 找到
trait use statement区域，把Wrap always改成Do not wrap - 取消勾选
Sort use statements（除非你真用 PHP-CS-Fixer 统一管） - 如果用了 PHP 8.2 的
enum，记得检查Enum constants下的大小写和换行设置，旧版 PhpStorm 容易忽略它
格式化快捷键失效或作用范围不对
按 Ctrl+Alt+L（macOS 是 Cmd+Option+L）没反应？不是快捷键冲突，大概率是当前光标在字符串/注释里，或者文件类型没识别成 PHP（看右下角显示是不是 PHP）。
- 确保文件后缀是
.php，且没有被误判为Text或HTML - 选中一段代码再格式化，只会作用于选区；全选后再格式化才整文件生效
- 想保存时自动格式化？开
Settings → Tools → Actions on Save → Reformat code，但别同时勾选Optimize imports，它可能删掉你故意留的 alias - 远程开发（SSH/WSL）下格式化延迟高？关掉
Enable Live Templates或调低Editor → General → Code Folding → Collapse by default
真正麻烦的是混合模板场景：PHP 文件里嵌了 Vue 或 Blade，格式化容易把 @foreach 或 <script setup> 搞崩。这时候得靠 // @formatter:off 临时禁用，而不是硬调全局规则。
