Sublime Text 本身不运行 PHP 也不内置调试器，所谓“高性能开发环境”本质是让编辑器与外部工具（PHP CLI、Xdebug、Debugger 插件）低延迟协同——关键不在 Sublime 多快，而在路径映射是否精准、端口是否通、触发逻辑是否被绕过。
Sublime Text 本身不运行 PHP，也不内置调试器，所谓“高性能开发环境”本质是让编辑器与外部工具（PHP CLI、Xdebug、Debugger 插件）低延迟协同——关键不在 Sublime 多快，而在路径映射是否精准、端口是否通、触发逻辑是否被绕过。
确认 Xdebug 3.x 已加载且监听正确端口
所有调试失败的根源，90% 出在这里。Sublime 不会报错，只会“静默不中断”，所以必须前置验证：
- 在浏览器打开
phpinfo()页面，搜索Xdebug，确认模块存在且版本 ≥ 3.0；若没看到，php -m | grep xdebug也应有输出 - 检查
php.ini中是否启用新版配置：xdebug.mode=debug（不是xdebug.remote_enable=1），xdebug.start_with_request=trigger（避免全站拦截），xdebug.client_host=127.0.0.1，xdebug.client_port=9003 - 重启 Web 服务（如 Nginx + PHP-FPM）或 Apache；Windows 用户注意：XAMPP/WAMP 的 php.ini 路径常有多个，务必改对正在用的那个
- 用
telnet 127.0.0.1 9003测试端口是否可被 PHP 进程访问（不是 Sublime 连它，是 PHP 主动连它）；不通就查防火墙或 Docker 网络隔离
选 Debugger 插件而非 SublimeXdebug
截至 2026 年，SublimeXdebug 仅支持 Xdebug 2.x，且已多年未更新，对 PHP 8.2+、Docker 路径映射、$_SESSION 变量展开等支持极差；Debugger（rprichard 维护）是唯一稳定选择：
- 通过 Package Control 安装
Debugger，不要搜 “Xdebug” —— 搜 “Debugger” 即可 - 安装后菜单栏走
Tools → Debugger → Open Launch Configurations，选 PHP 模板自动生成配置，别手写 - 生成的配置中，
"port": 9003必须与php.ini中xdebug.client_port一致；"type": "php"不可改为"xdebug"或其他值 - 状态栏右下角出现
Debugger: PHP才算配置加载成功；若没出现，检查配置文件是否保存在用户设置里（不是项目设置）
pathMappings 必须严格匹配容器/服务器路径
断点变灰色、变量显示 undefined、跳转到错误文件——几乎全是 pathMappings 填错了。它不是“本地路径 → 本地路径”，而是“PHP 实际执行时看到的绝对路径 → 你 Sublime 里打开的本地路径”：
立即学习“PHP免费学习笔记（深入）”；
- 若 PHP 运行在 Docker 容器内，左边填容器内路径，如
"/var/www/html"，不是宿主机的/Users/me/project - 若用 WSL2，左边填 WSL 内路径（如
/home/user/project），不是 Windows 的C:\wsl\project - 右边统一用
"${folder}"，代表当前 Sublime 项目根目录；不要硬编码，否则换机器就崩 - 路径末尾斜杠必须一致：
"/var/www/html/"和"/var/www/html"是两个不同路径，Xdebug 不做自动补全
启动调试前必须完成三件事
Debugger 插件不会主动拉起调试会话，它只监听连接。少一步，就永远等不到断点命中：
- 在 PHP 文件中点击行号左侧设断点，红点出现才算生效；灰色 = 路径没映射上，或文件没被 Xdebug 加载（比如开头缺
<?php） - 浏览器装
Xdebug Helper插件，并手动点击虫子图标启用（仅安装不启用 = 白装） - 访问 URL 时必须带
?XDEBUG_SESSION_START=1参数，例如http://localhost/index.php?XDEBUG_SESSION_START=1；用 curl 测试也行：curl "http://localhost/test.php?XDEBUG_SESSION_START=1" - macOS/Linux 用户特别注意：从 Dock 或 Spotlight 启动 Sublime，它不继承终端里的
PATH和php.ini；必须在终端执行subl .启动项目，否则插件读不到正确的 PHP 环境
最易被忽略的是 PHP CLI 和 Web SAPI 使用的 php.ini 不一致——php -v 显示的版本和 phpinfo() 可能完全不同；调试时用的是 Web 版本的配置，但 Sublime 插件可能默认调用 CLI 版本的 php 命令去解析路径。务必确认两者指向同一份 php.ini，否则 pathMappings 再准也没用。
