首先安装PHP CS Fixer工具并将其放置于系统指定目录,确保PHP环境正常;接着在Sublime Text中通过Package Control安装PHP CS Fixer插件;然后在插件设置中配置php_cs_fixer_exec_path和php_path指向正确的PHAR文件和PHP可执行文件路径;之后可通过快捷键Ctrl+Alt+F(Windows/Linux)或Cmd+Alt+F(macOS)格式化当前PHP文件;最后可在项目根目录创建.php_cs.dist文件自定义编码规范如@PSR2、短数组语法等规则。

要在 Sublime Text 中配置 PHP CS Fixer 实现 PHP 代码自动格式化,需先安装并配置相关插件和工具。整个过程不复杂,只要一步步来基本都能成功。
1. 安装 PHP CS Fixer 工具
PHP CS Fixer 是一个命令行工具,必须先在系统中安装好。
- 前往 https://github.com/FriendsOfPHP/PHP-CS-Fixer 下载 phar 文件
- 将下载的
php-cs-fixer.phar放到一个固定目录,例如:/usr/local/bin/php-cs-fixer.phar(macOS/Linux)或C:\tools\php-cs-fixer.phar(Windows) - 确保系统已安装 PHP 并能通过命令行运行
- 测试是否可用:打开终端执行
php php-cs-fixer.phar --version
2. 安装 Sublime 插件
推荐使用 Sublime PHP CS Fixer 插件,它专为集成该工具设计。
- 打开 Sublime Text,按下 Ctrl+Shift+P 调出命令面板
- 输入 Package Control: Install Package
- 搜索并安装 PHP CS Fixer
3. 配置插件路径
告诉插件 PHP CS Fixer 的实际位置。
立即学习“PHP免费学习笔记(深入)”;
- 点击菜单栏:Preferences → Package Settings → PHP CS Fixer → Settings
- 在右侧用户设置中添加以下内容(根据你的系统修改路径):
{
"php_cs_fixer_exec_path": "/usr/local/bin/php php-cs-fixer.phar",
"php_path": "/usr/local/bin/php"
}
Windows 用户示例:
{
"php_cs_fixer_exec_path": "C:\\php\\php.exe C:\\tools\\php-cs-fixer.phar"
}
注意:路径中的反斜杠要转义,或者使用正斜杠也可。
4. 使用快捷键格式化代码
配置完成后,在打开的 PHP 文件中:
- 按下 Ctrl+Alt+F(Windows/Linux)或 Cmd+Alt+F(macOS)即可自动格式化当前文件
- 也可以右键选择 Format this file with PHP CS Fixer
如果没反应,检查控制台输出(View → Show Console),看是否有路径错误或 PHP 执行问题。
5. 可选:自定义修复规则
在项目根目录添加 .php_cs.dist 或 .php_cs 文件来自定义格式规范:
setRules([
'@PSR2' => true,
'array_syntax' => ['syntax' => 'short'],
'no_unused_imports' => true,
])
->setFinder(
PhpCsFixer\Finder::create()->in(__DIR__ . '/src')
);
这样插件会按你定义的规则进行格式化。
基本上就这些。只要路径配对了,PHP 环境正常,一般都能顺利运行。











