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%appDataRoamingComposervendorbin(windows)已加入系统 PATH。 - 本地方式:在项目根目录运行
composer require --dev friendsofphp/php-cs-fixer,可执行文件位于vendor/bin/php-cs-fixer(Linux/macOS)或vendorbinphp-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,内容示例:
<?php return PhpCsFixerConfig::create() ->setRules([ '@PSR2' => true, 'array_syntax' => ['syntax' => 'short'], 'no_unused_imports' => true, ]) ->setFinder( PhpCsFixerFinder::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)是否有报错提示。