首选PHP-CS-Fixer插件，但需手动配置php-cs-fixer可执行文件绝对路径、正确设置快捷键触发条件（已保存.php文件）、使用@PSR12等兼容性规则，并警惕格式化引发的语义变化。
PHP 格式化插件选哪个？别装 PHP-CS-Fixer 就直接开干
Sublime Text 本身不带 PHP 代码格式化能力，必须靠插件。最常用、维护最稳的是 PHP-CS-Fixer，但它依赖本地 PHP 环境和命令行工具，不是装上插件就自动好用。很多人卡在这一步，以为插件没生效，其实是没配对 php-cs-fixer 可执行文件路径。
- 必须先在系统里安装
php-cs-fixer（推荐用 Composer 全局安装：composer global require friendsofphp/php-cs-fixer） - 确认终端能直接运行：
php-cs-fixer --version，不行就检查$PATH或 Composer bin 目录是否加入环境变量 - Sublime 插件设置里填的
php_cs_fixer_path必须是绝对路径，比如 macOS 上可能是/Users/xxx/.composer/vendor/bin/php-cs-fixer，Windows 上注意用正斜杠或双反斜杠 - 别用插件自带的“下载二进制”功能——它早就不更新了，容易报
file not found或版本不兼容
怎么绑定一键快捷键？别只改 Preferences → Key Bindings
光在用户键位文件里加一条 {"keys": ["ctrl+alt+f"], "command": "php_cs_fixer"} 不够。这个命令实际调用前会检查当前文件是否为 PHP 类型、是否有保存路径、是否启用了规则配置——任一条件不满足，就静默失败，没提示也没报错。
- 确保文件已保存且后缀是
.php（未保存的临时标签页或.inc文件默认不触发） - 检查插件设置里的
on_save是否设为false，否则可能和保存动作冲突，导致快捷键无效 - 如果想支持选择代码块格式化（而非整文件），得额外启用
apply_to_whole_file设为false，并确认当前有选中文本 - Windows 用户注意：快捷键别用
ctrl+shift+f，它和系统查找冲突，Sublime 会直接忽略
php-cs-fixer 规则怎么配才不翻车？别直接抄网上的 .php-cs-fixer.php
规则文件决定格式化结果，但 Sublime 插件默认读取项目根目录下的 .php-cs-fixer.php 或 .php-cs-fixer.dist.php。很多人复制别人配置后发现缩进没变、else 换行还是错的，问题常出在规则粒度或 PHP 版本不匹配。
- 新手建议从官方预设起步：
['@PSR12']（比@Symfony更宽松，兼容性更好） - 如果团队用 Laravel，加
'array_syntax' => ['syntax' => 'short']，否则[1, 2]会被强行改成array(1, 2) - 避免写死 PHP 版本规则，比如
'php_unit_method_casing' => true在 PHP 8.2+ 才生效，低版本会跳过且不报错 - 规则文件里不要用
return (new PhpCsFixer\Config())->setRules(...)风格——Sublime 插件只认简单数组返回值
格式化后代码跑不了？先看这三处隐藏改动
php-cs-fixer 是代码重写器，不是美化器。它可能在你没注意时改语义，尤其涉及空格、括号、操作符周围空白——这些改动本身合法，但可能触发某些静态分析工具或老旧框架的解析异常。
立即学习“PHP免费学习笔记（深入）”；
- 它默认启用
concat_space，把$a.'b'改成$a . 'b'，某些严格模式的 PHP 解析器（如旧版 HHVM）会报 warning -
binary_operator_spaces规则会让$a+$b变成$a + $b，如果项目里混用了模板引擎（如 Twig 表达式），可能和模板语法冲突 - 如果用了
no_unused_imports，它会删掉未使用的use语句——但有些类是通过字符串反射加载的（如new $className()），删了就直接Class not found
上线前务必跑一遍单元测试，尤其是涉及字符串拼接、动态类名、注解解析的逻辑。格式化不是终点，而是验证起点。
