必须手动应用PSR-12模板并校准关键细节：进入Settings → Editor → Code Style → PHP，点击Set from→PSR-12，勾选After keyword空格规则，Braces placement设为Next line，Spaces within parentheses取消勾选，并确保Scheme选Project且配好PHP-CS-Fixer。
PhpStorm 不会自动套用 PSR-12，必须手动导入模板并校准关键项，否则 Ctrl+Alt+L 格式化出来的代码大概率和团队 CI 报错的不一致。
怎么快速应用 PSR-12 内置模板
别从零调参数，先拉预设再微调：
- 打开
Settings / Preferences → Editor → Code Style → PHP - 点右上角
Set from…→Predefined style → PSR-12（不是 PSR-2，它已废弃） - 务必点
Apply—— 只点OK不会保存括号位置、空格等关键项 - 此时预览区显示符合 PSR-12 的示例代码，但只是骨架，不是全部规则
Braces placement 和 Spaces within parentheses 必须手动核对
这两个是 PSR-12 最常翻车的点，PhpStorm 默认值和标准冲突：
-
Braces placement → Brace position for control statements / functions：必须设为Next line，否则if ($x) {会被格式化成 K&R 风格，违反 PSR-12 -
Spaces → Within parentheses：必须取消勾选，否则foo($bar)会变成foo( $bar ) -
Spaces → After keyword下的if、for、function等都要勾选，确保if ($x)中关键字后有空格
为什么配了 PSR-12 还被 PHP-CS-Fixer 打回
因为 PhpStorm 的 Code Style 和外部工具（如 php-cs-fixer 或 phpcs）是两套独立系统：
立即学习“PHP免费学习笔记（深入）”；
- 确认项目根目录有
.php-cs-fixer.php或phpcs.xml，且内容明确包含@PSR12或<rule ref="PSR12"> - 在
Settings → Languages & Frameworks → PHP → Code Sniffer中，Path to phpcs必须指向真实可执行文件（如vendor/bin/phpcs），不能留空或填错路径 - 在
Settings → Editor → Inspections → PHP → PHP Code Sniffer validation中，Coding standard必须选Custom并指向你的phpcs.xml - 如果用
php-cs-fixer，建议在Tools → External Tools里配置为快捷命令，绑定到Ctrl+Shift+Alt+F类快捷键
团队协作时怎么确保风格绝对一致
靠人肉记忆或口头约定不可靠，必须导出可提交的配置：
- 在
Code Style → PHP页面，点右上角Manage… → Export，保存为php-style.xml - 把这个文件提交到 Git 仓库根目录，让所有人从版本库拉取后通过
Manage → Import导入 - 检查
.idea/codeStyles/Project.xml中是否包含<option name="PREFERRED_PROJECT_CODE_STYLE" value="PHP"/>，确保项目级 Scheme 生效 - 注意：如果项目启用
PHP-CS-Fixer，编辑器格式化只做基础缩进/空格，具体规则交给外部工具——别在 PhpStorm 里重复控制
最容易被忽略的是：PSR-12 本身不包含文档块校验（比如 @return 缺失），这类提示必须靠 Squiz.Commenting.FunctionComment 这类 sniff 显式启用，且要写进 phpcs.xml 才生效。
