Sublime Text 可通过插件实现保存时自动运行 PHP CS Fixer 格式化代码:需安装 PHP 和 php-cs-fixer 可执行文件、安装 PHP CS Fixer 插件、配置绝对路径及启用 on_save 和 format_on_save 选项,并可选添加项目级 .php-cs-fixer.php 规则文件。

Sublime Text 本身不内置 PHP CS Fixer 支持,但通过插件 + 正确配置,可以实现在保存时自动运行 PHP CS Fixer 格式化代码。关键在于:安装 PHP CS Fixer 可执行文件、安装 Sublime 插件、配置插件调用路径和规则。
1. 安装 PHP CS Fixer
确保系统中已安装 PHP(7.2+),然后选择以下任一方式获取 php-cs-fixer 可执行文件:
-
推荐方式(全局):用 Composer 全局安装:
composer global require friendsofphp/php-cs-fixer
之后确认~/.composer/vendor/bin/(macOS/Linux)或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin\(Windows)已加入系统 PATH。 -
本地方式:在项目根目录运行
composer require --dev friendsofphp/php-cs-fixer,可执行文件位于vendor/bin/php-cs-fixer(Linux/macOS)或vendor\bin\php-cs-fixer.bat(Windows)。
2. 安装 Sublime 插件:PHP CS Fixer
打开 Sublime Text → Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Windows/Linux)→ 输入 Package Control: Install Package → 搜索并安装 PHP CS Fixer(作者:nbs-system)。
安装后重启 Sublime(部分版本需要)。
立即学习“PHP免费学习笔记(深入)”;
3. 配置插件启用“保存时自动格式化”
打开插件设置:
菜单栏 → Preferences → Package Settings → PHP CS Fixer → Settings
在右侧用户设置中填入以下内容(根据你的环境调整路径和选项):
{
"php_cs_fixer_path": "/Users/yourname/.composer/vendor/bin/php-cs-fixer",
"on_save": true,
"config": ".php-cs-fixer.php",
"format_on_save": true,
"auto_fix": true
}
-
php_cs_fixer_path:必须填写绝对路径,指向你的
php-cs-fixer可执行文件(可用终端执行which php-cs-fixer或where php-cs-fixer查看)。 - on_save 和 format_on_save:启用保存即格式化。
-
config:指定配置文件名(如
.php-cs-fixer.php或.php-cs-fixer.dist.php),该文件需放在项目根目录;若留空则使用默认规则集。
4. (可选)添加项目级配置文件
在项目根目录创建 .php-cs-fixer.php,内容示例:
setRules([
'@PSR2' => true,
'array_syntax' => ['syntax' => 'short'],
'no_unused_imports' => true,
])
->setFinder(
PhpCsFixer\Finder::create()
->in(__DIR__.'/src')
->in(__DIR__.'/tests')
->name('*.php')
);
这样 Sublime 就会按你定义的规则来格式化,而不是默认 PSR-12。
基本上就这些。配置完成后,保存 PHP 文件时,插件会自动调用 php-cs-fixer 执行修正。如果没反应,优先检查 php_cs_fixer_path 是否正确、PHP 环境是否可用、以及 Sublime 控制台(View → Show Console)是否有报错提示。











