PhpStorm的PHP代码格式化规则必须设在Editor→Code Style→PHP，确认Scheme正确并点击Apply才生效；右上角Scheme下拉框显示当前配置，项目级Scheme优先于全局，需检查.idea/codestyles/Project.xml文件。
PhpStorm 的 PHP 代码格式化规则必须设在 Editor → Code Style → PHP，且需确认 Scheme 正确、点 Apply 才生效；不这样做，改了也白改。
怎么确认当前用的是哪个 Code Style Scheme
右上角的 Scheme 下拉框显示的名称，就是当前生效的配置。常见陷阱是：你改的是 Default，但项目实际绑定了 Project Scheme —— 这时所有调整都不会反映到文件里。
- 检查项目根目录下是否有
.idea/codestyles/Project.xml，有就说明启用了项目级 Scheme - 想统一团队风格，建议直接在项目根目录启用
Use per-project settings（勾选 Settings → Editor → Code Style 右上角） - 改完记得点
Set from… → PSR-12再微调，别从空白模板硬配
PSR-12 关键项必须手动对齐，否则和 PHP-CS-Fixer 冲突
PhpStorm 默认的 K&R 风格（{ 跟在 if 后面）和 PSR-12 要求的 Allman 风格（{ 独占一行）不兼容，会导致格式化后被外部工具反复打回。
-
Braces placement→ 设为Next line（不是Next line shifted） -
Spaces within parentheses→ 关闭，否则foo($bar)会被塞成foo( $bar ) -
Method call chain→ 勾选Wrap always，避免$user->getProfile()->getAvatar()->resize()挤成一行 -
Array initializer → Align when multiline→ 关闭，它和某些 linter 对齐逻辑冲突
trait use 语句被自动重排怎么办
PhpStorm 2022.3+ 默认会对 use 语句排序并拆行，比如把 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，除非你真用phpcbf统一管 - PHP 8.2+ 的
enum常量换行设置也要单独检查，旧版 PhpStorm 容易忽略它
为什么 Ctrl+Alt+L 格式化没反应或只缩进不重排
不是快捷键坏了，大概率是作用域或文件识别问题。
- 光标在字符串、注释里，或文件右下角显示不是
PHP（而是Text或HTML），格式化规则压根不加载 - 选中了文本 → 只格式化选区；没选中 → 格式化整个文件；光标停在
class上 → 尝试格式化整个类 - 文件含 BOM 字节（尤其 Windows 保存的 UTF-8），会干扰解析器，去
Settings → Editor → File Encodings勾选Transparent native-to-ascii conversion并重开文件 - 项目 SDK 语言级别低于代码语法（如用了
readonly class却设成 PHP 7.4），进Project Settings → PHP → Language level改对版本
最常被忽略的是 Scheme 绑定和 Apply 按钮——改完不点它，等于没改；点了 OK 而非 Apply，部分设置也不生效。团队共享时，优先导出 Project.xml 而非依赖全局设置。
