确认 php -v 能在终端跑通是硬门槛，Sublime Text 所有 PHP 功能均依赖系统 PATH 中的 php 命令；若终端报错，则构建、语法检查、调试全会静默失败。
确认 php -v 能在终端跑通是硬门槛
Sublime Text 本身不带 PHP 解释器，所有“运行”“调试”“语法检查”都依赖系统 PATH 里的 php 命令。如果终端执行 php -v 报错，比如 'php' is not recognized（Windows）或 command not found: php（macOS/Linux），那后续任何构建、插件、调试全都会静默失败或报错。
常见卡点：
- macOS M1/M2 用户用 Homebrew 安装后，
which php返回的是/opt/homebrew/bin/php，但 GUI 启动的 Sublime 不继承 shell 的 PATH —— 别信“终端能跑，Sublime 就能用” - Windows XAMPP 用户路径常是
C: mppphpphp.exe，但构建系统里写["php.exe", ...]反而会找php.exe.exe，直接报错 - Linux 用户装了
php但没装php-cli包，php -v成功，php -l却提示“Command 'php' not found”，得补装sudo apt install php-cli
用 Build System 实现 Ctrl+B 快速验证接口返回值
不需要插件，也不用开浏览器或 Postman，单文件 PHP 接口逻辑（比如 api/user.php）用构建系统就能直接看到 echo 或 json_encode 输出结果。关键是把 "cmd" 写对，并匹配你的使用场景。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 想快速看接口原始输出：用
["php", "-f", "$file"]，不加-d display_errors=On也行，错误会直接打在面板里 - 想先过一遍语法再执行（避免改错后直接崩）：改成
["php", "-l", "$file"]，但注意它只报语法错误，不执行代码 - Windows 下路径含空格（如
C:Program Filesphpphp.exe）必须写成数组第一项：["C:\Program Files\php\php.exe", "-f", "$file"]，否则解析中断 - 务必保留
"selector": "source.php"，否则 Ctrl+B 对 .txt 或 .html 文件也触发，或者根本没反应
Xdebug 断点调试不是必须，但查变量/流程时不可替代
Build System 能看最终输出，但没法停在某一行看 $_GET 长啥样、$result 是不是 null、调用栈哪一层出的问题——这时候就得 Xdebug。它和 Sublime 之间没有原生通道，必须靠插件桥接，且两端配置必须咬合。
关键对齐点：
- Xdebug v3+ 必须设
xdebug.mode=debug，不是旧版的xdebug.remote_enable=1；xdebug.client_port默认是9003，Sublime 插件（如Debugger或SublimeXdebug）也得配成一样，端口不一致就连接不上 - PHP CLI 和 Web Server（Apache/Nginx）可能加载不同的
php.ini，调试时用的是 CLI 的配置，所以php -m | grep xdebug要有输出，phpinfo()页面里的却不一定管用 - 本地路径映射（
pathMappings）最容易漏：比如项目在/Users/me/project，但 Xdebug 日志里显示请求来自/var/www/html，就得在插件配置里写"pathMappings": { "/var/www/html": "/Users/me/project" }
别让 .phtml/.inc 文件变成纯文本
很多 PHP 接口文件用 .phtml（模板）、.inc（包含）、.module（Drupal）等后缀，Sublime 默认不识别为 PHP，导致无高亮、无补全、构建系统不触发——连 Ctrl+B 都按不出反应。
解决方法很简单，但必须走对入口：
- 打开这类文件 → 右下角点击当前语法名（比如 “Plain Text”）→ 选 “Open all with current extension as…” → 再选 “PHP”
- 更彻底：菜单 Preferences → Settings – Syntax Specific（注意不是 Settings – User），右侧加：
{"extensions": ["phtml", "inc", "module"]} - 别手动改
Packages/User/Preferences.sublime-settings，那里改的是全局设置，对语法关联无效
路径映射错、CLI 和 Web 的 php.ini 不一致、语法模式没切对——这三个点占了调试失败原因的八成。它们不显眼，但一漏就卡半天。
