首先安装配置Xdebug扩展，确保PHP环境启用并设置正确参数；接着通过Package Control安装SublimeXdebug插件；然后在Sublime项目中配置调试入口URL及相关选项；之后在代码中设置断点并启动调试会话，通过浏览器访问带XDEBUG_SESSION_START参数的链接触发调试；最后利用面板查看变量和执行流程，注意检查端口9003及配置生效情况。
要在 Sublime Text 中配置 Xdebug 调试 PHP，需要结合 Xdebug、PHP 和 SublimeText 插件（如 SublimeXdebug）来实现断点调试。以下是完整配置流程。
1. 安装并配置 Xdebug 扩展
Xdebug 是 PHP 的调试工具，必须先在 PHP 环境中启用。
- 打开 php.ini 文件（可通过 phpinfo() 查看路径） - 添加以下配置（根据你的环境调整）：- xdebug.mode=debug
- xdebug.start_with_request=yes
- xdebug.client_host=127.0.0.1
- xdebug.client_port=9003
- xdebug.log="C:\xdebug_log.txt" （可选，用于排查问题）
保存后重启 Web 服务器（Apache/Nginx）或 PHP 内置服务，并运行 php -m | grep xdebug 确认已加载。
2. 安装 Sublime Text 插件 SublimeXdebug
使用 Package Control 安装调试插件：
立即学习“PHP免费学习笔记（深入）”；
- 打开 Sublime Text，按下 Ctrl+Shift+P 调出命令面板
- 输入 "Install Package"，选择对应选项
- 搜索 "SublimeXdebug" 并安装
安装完成后，可通过菜单 Tools → Xdebug 查看相关命令。
3. 配置项目启动调试
确保当前是一个 Sublime 项目（.sublime-project 文件），右键项目根目录 → Project Settings，添加调试配置：
{
"settings": {
"xdebug": {
"url": "http://localhost/your-project/index.php",
"super_globals": true,
"watch": [
"$_GET",
"$_POST"
]
}
}
}- url：调试入口页面，可以是具体 PHP 文件
- 开启 super_globals 可查看全局变量
4. 启动调试会话
步骤如下：
- 在 PHP 文件中设置断点（点击行号旁空白区域）
- 打开 Sublime 的 Xdebug 面板：菜单 → Tools → Xdebug → Start Debugging
- 访问你配置的 URL，附加参数 ?XDEBUG_SESSION_START=1
- 例如：http://localhost/test.php?XDEBUG_SESSION_START=1
当执行到断点时，Sublime 会暂停并高亮当前行，可在右侧面板查看变量、调用栈等信息。
5. 常见问题排查
- 确保防火墙未阻止 9003 端口（Xdebug 默认端口）
- 检查 php.ini 配置是否生效（phpinfo() 中搜索 xdebug）
- 日志文件可帮助定位连接失败原因
- 浏览器可安装 Xdebug Helper 插件一键开启调试
基本上就这些。只要环境正确，SublimeXdebug 能稳定支持基础断点调试。适合轻量级开发场景。不复杂但容易忽略端口和启动参数。基本上就这些。
