必须启用Align key-value pairs开关，位于Settings→Editor→Code Style→PHP→Wrapping and Braces中，勾选后配合Ctrl+Alt+L（Windows/Linux）或Cmd+Option+L（macOS）即可实现数组=>对齐。
PHPStorm 中数组 => 对齐必须开哪个开关
对齐数组键值对，核心就一条：必须启用 Align key-value pairs。它不藏在“Code Style > PHP > Spaces”或“Tabs and Indents”里，而是在 Wrapping and Braces 页签中——注意不是 Other（旧版 2018 前确实在 Other，但新版统一挪到 Wrapping and Braces）。勾选后，Ctrl + Alt + L（Windows/Linux）或 Cmd + Option + L（macOS）才会把 => 拉到同一列。
常见错误现象：
– 格式化后 => 位置参差不齐，甚至完全没动
– 设置里搜 “align” 找到多个相似选项，误勾了 Align array initializer elements（这个只管方括号内换行缩进，不管 => 对齐）
– 项目级设置覆盖了全局设置，结果在某个项目里怎么调都不生效
为什么 Ctrl + Alt + L 有时不生效
快捷键本身没问题，失效往往是因为上下文或配置冲突：
- 光标没落在数组内部或没选中目标代码块 —— PhpStorm 默认只格式化当前作用域或选中区域，全选再按更稳妥
- 当前文件类型未识别为 PHP —— 检查右下角状态栏是否显示
PHP，否则设置不加载；可右键文件 →Override File Type→ 选PHP - 用了自定义的 Code Style Scheme 但没同步修改 —— 进入
Settings → Editor → Code Style → PHP，确认 Scheme 是Project还是Default，改完记得点Apply而非仅OK - 第三方插件干扰（比如某些 prettier 或 phpcs 插件启用了自动格式化钩子）—— 临时禁用插件测试是否恢复
数组尾随逗号和短语法要不要一起开
建议一起开，它们和 Align key-value pairs 是协同生效的组合项：
立即学习“PHP免费学习笔记（深入）”；
– Use short array syntax（在 Code Style → PHP → Code Generation）：强制把 array() 转成 []，避免混用
– Force trailing comma in arrays（同在 Code Generation）：加尾随逗号后，git diff 更干净，新增键值时也不用补逗号
这两个选项本身不影响对齐逻辑，但开启后格式化结果更统一。注意：尾随逗号在 PHP 7.3+ 完全合法，低于该版本慎用。
对齐后空格数量不可控？这是故意的
PHPStorm 的对齐不是靠硬塞空格实现的，而是基于“列对齐”策略：它会计算最长键名宽度，再让所有 => 起始位置对齐。所以你看到的空格数可能不一致（比如 'a' => 和 'long_key_name' => 之间空格数不同），这不是 bug，是设计行为。
如果你坚持每处空格数相同（例如全用 4 个空格），PHPStorm 做不到 —— 它不提供“固定间隔”模式。这种需求更适合用 php-cs-fixer 配合规则 binary_operator_spaces 或自定义 array_indentation，但那就脱离 IDE 内置能力了。
真要细粒度控制空格，得接受放弃 IDE 原生对齐，转而依赖外部工具链。日常开发中，列对齐带来的可读性提升远大于空格数是否整齐这点强迫症。
