Sublime Text 本身不支持 PHP 代码一键美化，必须依赖 php-cs-fixer CLI 工具 + 插件协同工作；需先用 Composer 全局安装 php-cs-fixer 并验证命令可用，再在插件设置中填入绝对路径，重启 Sublime 后配合正确语法识别（右下角显示“PHP”）和保存后的 .php 文件，方可通过快捷键（如 Ctrl+Alt+F）触发格式化。
Sublime Text 本身不支持 PHP 代码一键美化，必须依赖 php-cs-fixer CLI 工具 + 插件协同工作；装上插件但没配对 php-cs-fixer 可执行路径，90% 的人会卡在“按了快捷键没反应”这一步。
确认 php-cs-fixer 命令行能直接运行
插件只是个“遥控器”，真正干活的是你系统里的 php-cs-fixer。如果终端里输 php-cs-fixer --version 报 command not found，后续所有配置都白搭。
- 推荐用 Composer 全局安装：
composer global require friendsofphp/php-cs-fixer - 安装完立刻验证：
php-cs-fixer --version—— 必须有输出，否则检查$PATH是否包含 Composer bin 目录（macOS/Linux 通常是~/.composer/vendor/bin，Windows 是%APPDATA%\Composer\vendor\bin） - 别用插件内置的“下载二进制”功能：它早已停止更新，容易触发
file not found或 PHP 版本兼容错误
插件设置里填的必须是绝对路径
Sublime 插件读取的 php_cs_fixer_path 不接受相对路径、别名或 shell 函数，只认硬编码的绝对路径——哪怕多一个空格或错用反斜杠都会静默失败。
- macOS/Linux 示例：
"/Users/xxx/.composer/vendor/bin/php-cs-fixer"（注意引号和正斜杠） - Windows 示例：
"C:/Users/xxx/AppData/Roaming/Composer/vendor/bin/php-cs-fixer.bat"（推荐正斜杠，避免双反斜杠转义问题） - 如果用了 PHAR 文件方式，路径要写成：
"php C:/tools/php-cs-fixer.phar"，并确保php_path指向有效的php.exe - 改完设置后务必重启 Sublime，否则新路径不会加载
快捷键触发有条件，不是按下就执行
ctrl+alt+f 这类快捷键默认只在满足全部条件时才调用格式化：文件已保存、后缀是 .php、语法识别为 PHP（右下角显示 “PHP”）、插件配置中 on_save 没和保存动作冲突。
立即学习“PHP免费学习笔记（深入）”；
- 未保存的临时标签页、
.inc或.module文件，默认不触发 —— 解决办法：先Ctrl+S保存为.php - 如果启用了
on_save: true，再绑定快捷键，可能因执行时机重叠导致静默跳过 —— 建议设为false，手动控制更可靠 - 想格式化选中代码块而非整文件？得在插件设置里显式开启
apply_to_whole_file: false，否则选中后按快捷键仍会格式化全文 - Windows 用户避开
ctrl+shift+f：它和系统级查找热键冲突，Sublime 会直接忽略该绑定
规则文件位置和内容决定格式化结果
插件默认读取项目根目录下的 .php-cs-fixer.php 或 .php-cs-fixer.dist.php。没有这个文件，就走插件内置默认规则（通常很宽松），缩进、括号换行、数组语法等都不会按 PSR12 处理。
- 最简可用规则文件内容（放在项目根目录）：
return PhpCsFixer\Config::create()->setRules(['@PSR12' => true]);
- 团队用 Laravel？加一行：
'array_syntax' => ['syntax' => 'short']，否则[1, 2]会被强制改成array(1, 2) - 别在规则里写 PHP 8.2+ 才支持的项（如
php_unit_method_casing）却跑在 PHP 7.4 环境——它会跳过且不报错，你根本意识不到规则没生效 - 规则文件名必须严格匹配：
.php-cs-fixer.dist.php有效，.php_cs_fixer.php无效
最容易被忽略的是：格式化可能改变语义。比如把 if ($a == $b) 改成 if ($a === $b)（启用 strict_param 规则时），这种修改不会高亮提示，但可能让代码行为突变。上线前务必做 diff 和基础逻辑验证。
