PhpStorm保存时自动格式化需同时开启Code Style规则和Tools→Actions on Save中的Reformat code；须确认文件类型为PHP、Scheme选对、.editorconfig未冲突，且点击Apply保存设置。
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，这里只管缩进/空格等基础项，别和外部工具重复控制
Tools → Actions on Save 中必须勾选 Reformat code
这个选项不在 Editor 标签页，而在 Tools → Actions on Save。很多人翻遍 Code Style 和 General 都找不到，就是因为路径错了。
- 必须勾选
Reformat code，否则其他设置全白搭 - 该设置是项目级的，新建项目要重新开一次，不会继承全局
- 如果保存后没反应，先检查当前文件是否被识别为
PHP File（右下角状态栏看文件类型），否则格式化逻辑压根不触发 - 同时启用了
Optimize imports可能打乱已有 import 顺序，尤其在团队用不同 import 规则时
为什么 Ctrl+S 后代码没变样？常见排查点
开了开关却没反应，大概率是代码风格配置为空或冲突。PhpStorm 的格式化行为完全依赖当前文件关联的 Code Style 配置，而不是“有没有装插件”或“有没有快捷键绑定”。
立即学习“PHP免费学习笔记（深入）”；
- 检查右下角状态栏是否显示
PHP，不是Text或Plain Text - 进入
Settings → Editor → Code Style → PHP，确认右侧预览区有实际规则（比如Brace style不是None） - 如果项目用了
.editorconfig，它会覆盖 PhpStorm 内置规则，此时改Settings没用，得调.editorconfig里的indent_style、max_line_length等字段 -
Reformat code是按文件类型分别控制的，PHP 文件生效，不代表.vue里的<script>块也会被格式化；需单独在齿轮图标里开启对应类型
PHP 文件里 开头没被格式化？这是特有坑
PhpStorm 默认把 当作 PHP 开始标记，但如果文件以 <?php 开头，且中间混有短标签 或 =，格式化可能跳过部分区域——尤其在未启用 Enable short tags 时。
- 进
Settings → Languages & Frameworks → PHP，确认Short Tags是否勾选（根据项目实际决定） - 如果用了 Blade 模板，
.blade.php文件里的 PHP 代码默认不被识别为 PHP 语言块，需右键@if等指令 →Inject language or reference→ 选PHP - 大文件（>2000 行）启用保存即格式化可能造成短暂停顿，建议搭配
Only changed lines（需 2023.2+ 版本） - 注意：如果同时配置了
php-cs-fixer或Prettier，它们和内置格式化器不能共存于同一文件类型，否则会出现空行反复增删、分号来回加减等问题
