首先安装并启用Xdebug扩展，确保php.ini配置正确且服务重启；接着通过Package Control安装SublimeXdebug插件；然后在项目设置中配置调试URL和端口9003；最后在Sublime中设断点并按F8启动监听，浏览器访问页面即可触发调试。
要在 Sublime Text 中配置 PHP Xdebug 实现断点调试，需要结合本地开发环境（如 XAMPP、WAMP 或 PHP 内置服务器）、Xdebug 扩展和 Sublime 的调试插件。下面是一步一步的配置方法，帮助你搭建完整的 PHP 调试环境。
1. 安装并启用 Xdebug 扩展
确保你的 PHP 环境已安装并正确启用了 Xdebug 模块。
检查 Xdebug 是否安装： 安装 Xdebug（以 Windows + WAMP/XAMPP 为例）：- 前往 https://www.php.cn/link/67614aacd469da7f9d611c9be60462f1
- 复制 phpinfo() 页面的全部内容粘贴到表单中，获取适配你 PHP 版本的 Xdebug 安装建议
- 下载对应的 DLL 文件，放入 php/ext/ 目录（例如：php_xdebug-*.dll）
- 编辑 php.ini 文件（不要使用 php.ini-development 等副本）
- 在文件末尾添加如下配置（根据版本调整路径）：
[XDebug]
zend_extension="路径/to/php_xdebug.dll"
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.log="C:\tmp\xdebug.log"
保存后重启 Apache 或 PHP 服务，再次查看 phpinfo() 确认 Xdebug 出现且 mode 为 debug。
2. 安装 Sublime Text 插件：SublimeXdebug
使用 Package Control 安装调试插件。
立即学习“PHP免费学习笔记（深入）”；
- 按下 Ctrl+Shift+P 打开命令面板
- 输入 Install Package，回车
- 搜索 SublimeXdebug 并安装
3. 配置项目启用调试
打开你要调试的 PHP 项目，在菜单栏选择 Project → Save Project As… 创建一个 .sublime-project 文件。
编辑项目配置，加入 Xdebug 设置：
{
"folders": [
{
"path": "."
}
],
"settings": {
"xdebug": {
"url": "http://localhost/your-project/",
"super_globals": true,
"auto_start": true,
"port": 9003
}
}
}
参数说明：
- url：项目的访问地址（必须能通过浏览器打开）
- port：与 php.ini 中 xdebug.client_port 一致
- auto_start：设为 true 可自动开启调试，无需手动加 GET 参数
4. 在 Sublime 中设置断点并启动调试
- 打开要调试的 PHP 文件
- 右键点击行号区域，选择 Xdebug: Toggle Breakpoint 设置断点
- 按下 F8 启动监听（状态栏显示 "Listening for Xdebug"）
- 在浏览器中访问该 PHP 页面（如 http://localhost/test.php）
如果配置正确，Sublime 会中断在断点处，并弹出变量监视窗口。你可以使用 F10（跳过）、F11（步入）等快捷键控制执行流程。
5. 常见问题排查
- 无法连接 Xdebug：检查防火墙是否阻止 9003 端口，或用 netstat 查看端口监听状态
- 断点不生效：确认 php.ini 配置正确，xdebug.log 中是否有错误日志
- 页面卡住不动：说明 Xdebug 已连接但 Sublime 未响应，检查是否开启了监听（F8）
- 跨平台问题（Linux/Mac）：路径分隔符和权限注意调整，zend_extension 使用绝对路径
基本上就这些。只要 Xdebug 能正常通信，SublimeXdebug 插件稳定支持基础断点调试，适合轻量级开发场景。虽然不如 PhpStorm 功能全面，但对于熟悉 Sublime 的用户来说足够实用。
