PSR-12模板需手动校准Braces placement为Next line、Spaces within parentheses取消勾选，并绑定PHP-CS-Fixer路径及phpcs.xml标准，否则格式化结果与CI不一致。
PSR-12 模板必须手动校准，否则格式化结果和 CI 不一致
PhpStorm 自带的 Set from → PSR-12 只是加载骨架，不等于开箱即用。最常翻车的是两个位置：Braces placement 和 Spaces within parentheses。
默认值会把 if ($x) { 格式化成 K&R 风格（左花括号在行尾），但 PSR-12 明确要求控制语句和函数的花括号必须换行（Next line）；而 Spaces within parentheses 若勾选，会导致 foo($bar) 变成 foo( $bar )，违反规范。
-
Braces placement → Brace position for control statements / functions：必须设为Next line -
Spaces → Within parentheses：必须取消勾选 -
Spaces → After keyword：确保if、for、function等都勾选 - 点
Apply，不是只点OK—— 后者不会保存括号/空格等关键项
PHP-CS-Fixer 和 PhpStorm 的代码风格是两套系统，不能互相替代
配完 PSR-12 模板后，CI 仍报错，大概率是因为 PhpStorm 的格式化逻辑和 php-cs-fixer 或 phpcs 完全独立。IDE 不会读取你的 .php-cs-fixer.php，也不会自动对齐 phpcs.xml 中的规则。
要让两者协同工作，必须显式绑定：
立即学习“PHP免费学习笔记（深入）”；
-
Settings → Languages & Frameworks → PHP → Code Sniffer：填入真实可执行路径，如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类组合，避免依赖 IDE 内置格式化
团队统一风格靠导出配置文件，不是靠口头约定
靠人记住“花括号换行”“括号内不加空格”不可靠。真正能落地的方案是把校准后的配置导出为机器可读文件，并提交进 Git。
操作路径：Settings → Editor → Code Style → PHP → Manage… → Export，保存为 php-style.xml。
- 把这个文件提交到项目根目录，所有人拉取后通过
Manage → Import加载 - 检查
.idea/codeStyles/Project.xml中是否含<option name="PREFERRED_PROJECT_CODE_STYLE" value="PHP"/>，确保项目级 Scheme 生效 - 如果用了
php-cs-fixer，同步提交.php-cs-fixer.php或php-cs-fixer.config.php，且内容明确包含@PSR12
Live Templates + SnippetMaker 插件比纯手动写更易维护
团队高频复用的结构（如 API 响应包装、日志模板、Eloquent 查询链）不适合靠记忆或复制粘贴。原生 Live Templates 支持变量占位和上下文限定，但管理混乱；SnippetMaker 插件提供侧边栏界面，支持标签分组、跨项目搜索、一键保存选中代码为新片段。
例如定义一个 resp 模板：
return response()->json([
'code' => $CODE$,
'message' => '$MESSAGE$',
'data' => $DATA$
]);
再配合 SnippetMaker 打上 laravel、api 标签，比散落在不同 Live Template 组里更易查找和更新。
真正难的不是配一次，而是每次框架升级（比如 Laravel 12 引入新响应类）、PHP 版本切换（比如弃用 create_function）时，能否快速批量更新所有模板和检查规则 —— 这部分没自动化，就永远卡在“基本可用”阶段。
