phpstorm需手动开启代码风格规则和保存时触发格式化两个开关：规则在editor→codestyle→php中配置并选对scheme，触发在tools→actionsonsave中勾选reformatcode。
PhpStorm 默认不自动格式化，必须手动开两个开关：一个是代码风格规则，另一个是触发时机（比如保存时）。只配规则不配触发，等于写了菜谱但不下锅。
Code Style → PHP 里配规则，但 Scheme 必须选对
规则不在 Editor → General 里，而在 Editor → Code Style → PHP。进去第一件事是看右上角的 Scheme 下拉框——如果显示的是 Default，而你项目用的是团队自定义方案，那改了也白改。
- 新建项目建议勾选
Use per-project settings，避免和全局配置打架 - 点
Set from…选PSR-12是最快起步方式，再微调Braces placement、Spaces within parentheses这类高频项 - 改完一定要点
Apply（仅点OK不会保存部分设置） - 如果团队用
php-cs-fixer，这里只管缩进/空格等基础项，别和外部工具重复控制
Actions on Save 开关藏得深，且必须单独勾选
这个选项不在 Editor 标签页，而在 Tools → Actions on Save。很多人翻遍 Code Style 和 General 都找不到，就是因为路径错了。
- 必须勾选
Reformat code，其他如Optimize imports是可选项，但一起开可能打乱已有 import 顺序 - 该设置是项目级的，新建项目要重新开一次，不会继承全局
- 如果保存后没反应，先检查当前文件是否被识别为
PHP File（右下角状态栏看文件类型），否则格式化逻辑压根不触发
快捷键 Ctrl + Alt + L 失效？先查绑定和上下文
默认快捷键是 Ctrl + Alt + L（macOS 是 Cmd + Option + L），但它只在编辑器有焦点、且光标落在 PHP 文件内容区时才生效。
- 如果按了没反应，去
Settings → Keymap搜索Reformat Code，确认绑定没被覆盖 - 系统级快捷键（比如某些输入法或录屏工具）可能劫持
Ctrl + Alt + L，可临时改成Ctrl + Alt + Shift + L - 选中一段代码再按快捷键，只会格式化选中区域；不选中则作用于整个文件
- 注意：
Ctrl + Shift + Alt + L是另一个命令（带弹窗的批量格式化），别和默认快捷键混淆
想和 php-cs-fixer / PHP_CodeSniffer 同步？别全靠 IDE 内置规则
IDE 内置格式化和 phpcbf 的行为并不完全一致，尤其在数组展开、箭头函数、属性类型等细节上。硬凑容易出“格式化一次变样，再格式化又变回去”的循环。
- 推荐做法：IDE 只负责基础缩进和括号风格，复杂规则交给
php-cs-fixer，通过External Tools或File Watchers调用 - 配置
phpcbf时，Working directory设为$ProjectFileDir$，Arguments用--standard=PSR12 $FilePath$ - 如果用 Git 提交前检查，
grumphp比 IDE 钩子更可靠，因为绕过了开发者的主观跳过操作
真正麻烦的不是设置步骤，而是规则来源不统一：.editorconfig、IDE Scheme、php-cs-fixer 配置、pre-commit hook 各管一摊。一旦发现格式化结果反复波动，优先检查这四者是否在同一个标准上对齐，而不是继续调 IDE 里的滑块。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
