首先安装PHP_CodeSniffer和PHPCBF,再通过Package Control安装SublimeLinter与SublimeLinter-phpcs插件,接着配置phpcs可执行文件路径及编码标准如PSR12,然后设置自定义构建系统或快捷键调用phpcbf实现自动修复,最后验证错误提示与格式化功能是否正常。

在 Sublime Text 中配置 PHPCS(PHP_CodeSniffer)和 PHPCBF(PHP Code Beautifier and Fixer)可以让你在编写 PHP 代码时实时检查编码规范,并自动修复格式问题。以下是详细的配置步骤:
1. 安装 PHP_CodeSniffer 和 PHPCBF
确保你的系统已安装 PHP,并通过 Composer 全局安装 PHP_CodeSniffer:
运行命令:
composer global require squizlabs/php_codesniffer composer global require friendsofphp/php-cs-fixer # 可选:作为替代或补充
安装完成后,确认 phpcs 和 phpcbf 命令可用:
立即学习“PHP免费学习笔记(深入)”;
phpcs --version phpcbf --version
如果提示命令未找到,请将 Composer 的全局 bin 目录加入系统 PATH(通常为 ~/.composer/vendor/bin 或 ~/.config/composer/vendor/bin)。
2. 安装 Sublime 插件:SublimeLinter 和 SublimeLinter-phpcs
打开 Sublime Text,使用 Package Control 安装以下插件:
- SublimeLinter:代码检查框架
- SublimeLinter-phpcs:PHPCS 集成插件
安装方法:
- 按下 Ctrl+Shift+P 打开命令面板
- 输入 “Package Control: Install Package”
- 搜索并安装
SublimeLinter和SublimeLinter-phpcs
3. 配置 SublimeLinter-phpcs
进入插件设置:
路径: Preferences → Package Settings → SublimeLinter → Settings
在右侧用户设置中添加如下配置(根据实际路径调整):
{
"linters": {
"phpcs": {
"executable": "/Users/yourname/.composer/vendor/bin/phpcs",
"args": [
"--standard=PSR12" // 可改为 PSR2、Zend、PEAR 等
],
"disable": false,
"env": {}
}
}
}Windows 用户示例:
{
"linters": {
"phpcs": {
"executable": "C:\\Users\\YourName\\AppData\\Roaming\\Composer\\vendor\\bin\\phpcs.bat",
"args": ["--standard=PSR12"]
}
}
}4. 配置 PHPCBF 快捷修复(可选:使用 LSP 或自定义命令)
SublimeLinter-phpcs 本身不支持一键自动修复,可通过以下方式集成 phpcbf:
方法一:使用外部插件如 SublimeFixer 或 EasyClangComplete 类思路(推荐使用 Build System)
创建自定义构建系统:
- Tools → Build System → New Build System
- 输入以下内容:
{
"cmd": ["/Users/yourname/.composer/vendor/bin/phpcbf", "$file"],
"selector": "source.php",
"shell": true,
"working_dir": "$file_path",
"variants": [
{
"name": "PHPCBF Fix",
"cmd": ["/Users/yourname/.composer/vendor/bin/phpcbf", "$file", "--standard=PSR12"]
}
]
}- 保存为
PHPCBF.sublime-build
使用时打开 PHP 文件,按 Cmd+B 运行构建,或选择变体运行“PHPCBF Fix”来自动修复代码。
方法二:绑定快捷键执行 phpcbf
打开菜单:Preferences → Key Bindings,添加:
[
{
"keys": ["ctrl+alt+f"],
"command": "exec",
"args": {
"cmd": ["/Users/yourname/.composer/vendor/bin/phpcbf", "$file", "--standard=PSR12"],
"shell": true
},
"context": [{"key": "selector", "operator": "equal", "operand": "source.php"}]
}
]保存后,在 PHP 文件中按快捷键即可格式化当前文件。
5. 验证配置是否生效
新建一个 test.php 文件,写入不符合 PSR-12 的代码:
保存后,SublimeLinter 应该会在左侧标出错误。运行 PHPCBF 构建命令后,代码应被自动修复为标准格式。
基本上就这些。配置一次后,每次写 PHP 都能保持规范统一,提升协作效率。











