Sublime Text 需依赖系统 PHP 环境才能实现 PHP 开发功能；必须确保终端可执行 php -v，macOS/Linux 调整 PATH，Windows 配置系统 Path，构建系统需匹配真实 PHP 路径、转义反斜杠、处理编码与调试参数。
Sublime Text 本身不是 IDE，没法“配置成 PHP 开发环境”，它只能作为轻量编辑器配合外部工具工作；想直接运行、调试、跳转定义？得靠插件和系统级命令协同，而且每一步都容易卡在路径或权限上。
PHP CLI 命令必须能从终端直接调用
所有 Sublime 插件（比如 PHP Companion 或构建系统）底层都依赖系统能找到 php 命令。如果在终端输 php -v 报 command not found，Sublime 里任何 PHP 功能都会静默失败。
-
macOS：确认
/usr/bin/php存在，或 Homebrew 安装后把$(brew --prefix)/bin加进PATH（注意 Sublime 启动方式：从 Dock 点开可能不读 shell 配置，建议终端执行subl启动） - Windows：把 PHP 解压目录（如
C:\php）加到系统环境变量Path，重启 Sublime - Linux：检查
which php输出，确保普通用户权限下可执行
构建系统要匹配你的真实 PHP 路径和参数
Sublime 的 Tools → Build System → New Build System 写的不是“让 PHP 跑起来”，而是“告诉 Sublime 怎么调用你本地的 PHP 解释器”。默认模板里的 "cmd": ["php", "-l", "$file"] 看似简单，但实际会出三类问题：
- 路径错误：Windows 上没写全路径（如
"cmd": ["C:\\php\\php.exe", "-l", "$file"]），或反斜杠没转义 -
编码问题：PHP 文件含中文时，Windows 下需加
"encoding": "cp936"，否则报错Parse error: syntax error - 调试需求：想看
var_dump输出？得改"cmd": ["php", "-f", "$file"]，且确保文件有开头，否则直接退出
代码补全和跳转依赖 PHP Intelephense 插件 + 正确 workspace 配置
原生 Sublime 对 PHP 几乎零支持，PHP Intelephense 是目前唯一靠谱的补全/跳转方案，但它不是装完就灵——它需要明确知道你的项目结构和依赖位置。
立即学习“PHP免费学习笔记（深入）”；
- 必须通过
Package Control安装PHP Intelephense，不能手动丢文件夹 - 项目根目录下要有
composer.json或至少一个vendor/autoload.php，否则连echo都不提示 - 如果用了自定义命名空间或非标准 autoloader，得在
.intelephense.json里配"files.associations"和"environment.includePaths" - 首次索引很慢，状态栏显示
Indexing...时别关窗口，否则下次打开又重来
调试 PHP 不能只靠 Sublime，得接 Xdebug + 浏览器插件
Sublime 没内置调试器，Xdebug Client 插件只是个“接收器”，真正断点生效要三端对齐：PHP-FPM/Apache 的 xdebug.mode=debug、IDE key 设为 SUBLIME、浏览器装 Xdebug Helper 并点击虫子图标启用。
- 常见失败点：Xdebug 4.x 默认只监听 localhost，但 Sublime 插件默认连
127.0.0.1:9003，得在php.ini显式写xdebug.client_host=127.0.0.1 - Sublime 的
Project → Edit Project里要加"settings": {"xdebug": {"port": 9003}}，否则连错端口 - 断点只响应 HTTP 请求，命令行运行
php script.php不会触发调试
最常被忽略的是：Sublime 的 PHP 支持本质是“拼装”出来的——CLI 路径错一点、构建参数少个引号、Xdebug 版本和配置不匹配，整个链路就断在你看不见的地方。与其反复试配置，不如先在终端里把 php -v、php -m | grep xdebug、curl -I http://localhost 全跑通，再回 Sublime 配插件。
