Sublime Text 需依赖系统已安装的 PHP CLI 才能运行 PHP，首要确认终端执行 php -v 成功；接着配置 Build System 实现 Ctrl-B/Cmd-B 运行；再通过 PHP-CS-Fixer 或 phpcbf 插件联动实现代码格式化；调试则应交由 VS Code 或 PhpStorm 等专业工具完成。
Sublime Text 本身不内置 PHP 运行能力，所谓“配置 PHP 开发环境”，核心是让编辑器能调用系统已安装的 php 可执行文件完成语法检查、代码格式化、运行脚本等操作——没装好 PHP CLI，所有插件和构建系统都会报错。
确认 php 命令在终端可用
这是所有后续配置的前提。打开终端（macOS/Linux）或命令提示符/PowerShell（Windows），输入：
php -v
如果返回版本信息（如 PHP 8.2.12），说明 CLI 已就位；若提示 'php' is not recognized 或 command not found，请先安装 PHP 并把 php 所在路径加入系统 PATH。常见路径：
- macOS Homebrew：通常为
/usr/local/bin/php - Windows XAMPP：类似
C: mppphpphp.exe（注意 Windows 下要带.exe后缀） - Linux（apt）：一般为
/usr/bin/php
别跳过这步——很多“构建系统不工作”的问题，根源只是 php 命令根本找不到。
立即学习“PHP免费学习笔记（深入）”；
用 Build System 直接运行 PHP 文件
Sublime Text 的构建系统（Build System）是最轻量、最可控的 PHP 执行方式，不依赖插件，适合调试单文件脚本。
操作步骤：
- 菜单栏选择 Tools → Build System → New Build System…
- 替换默认内容为以下 JSON（注意根据你的系统调整
cmd中的路径）：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"file_regex": "^(...*?):([0-9]+):([0-9]+): (.*)$",
"working_dir": "$file_path"
}
保存为 PHP.sublime-build（自动存到 Packages/User/）。之后打开 .php 文件，按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）即可在底部面板看到执行结果。
⚠️ 容易踩的坑：
-
cmd里写成["php.exe", ...]—— Windows 下如果php已在 PATH 中，不用加.exe；加了反而可能因找不到php.exe.exe报错 - 忘记设置
"selector": "source.php"—— 导致快捷键对非 PHP 文件也生效，或无法触发 - 路径含空格（如
C:Program Filesphpphp.exe）没加引号 —— Windows 下会解析失败，应写成["C:\Program Files\php\php.exe", ...]
用 PHP-CS-Fixer 或 phpcbf 自动格式化代码
靠手动缩进和空格维持 PSR-12 风格不现实，推荐用命令行工具 + Sublime 插件联动。两个主流选择：
-
php-cs-fixer（社区活跃，规则丰富）：需全局安装composer global require friendsofphp/php-cs-fixer，确保其二进制可被找到（常位于~/.composer/vendor/bin/php-cs-fixer或%APPDATA%Composer endorinphp-cs-fixer.bat） -
phpcbf（PHP_CodeSniffer 自带）：安装后路径通常是phpcbf（PATH 中）或vendor/bin/phpcbf（项目局部）
安装插件 PHP Code Beautifier and Fixer（PCBF）或 PHP CS Fixer 后，在插件设置中填入你本地实际的可执行路径。例如 Windows 用户可能要填：
"php_cs_fixer_path": "C:\Users\YourName\AppData\Roaming\Composer\vendor\bin\php-cs-fixer.bat"
然后选中代码或整个文件，右键 → PHP CS Fixer: Fix this file 即可自动修正。
关键提醒：这些工具不会帮你装 PHP，也不会自动下载规则配置——.php_cs.dist 或 phpcs.xml 必须自己放项目根目录，否则格式化行为不可控。
调试？别指望 Sublime Text 原生支持 Xdebug
Sublime Text 没有内建调试器，Xdebug 是 PHP 的扩展，它只负责向 IDE 发送调试数据，而 Sublime Text 缺少接收并可视化断点、变量、调用栈的组件。有人用 sublime-php-debugger 插件尝试桥接，但维护停滞、兼容性差、Windows 支持弱，且要求手动配置 Xdebug 的 idekey 和远程主机设置。
如果你真需要步进调试：
- 用 VS Code +
PHP Debug插件（免费、活跃、开箱即用） - 或 PhpStorm（商业，但对 PHP 调试体验最完整）
Sublime Text 更适合写、查、跑、格式化——把调试交给更专业的工具，反而省时间。
真正卡住人的，往往不是“怎么配”，而是没分清哪些事该由编辑器做、哪些必须由外部工具链承担。PHP CLI 路径、构建系统的 working_dir、格式化工具的配置文件位置——这几个点反复确认，比套用十篇“收藏教程”更管用。
