首先安装PHP Companion、SublimeCodeIntel和Debugger插件，再配置本地PHP环境并启用Xdebug，在php.ini中设置xdebug.mode=debug及端口9003，最后在Sublime中通过Debugger插件设置pathMappings映射路径并启动调试，浏览器访问时附加XDEBUG_SESSION_START参数即可实现断点调试。
Sublime Text 本身不带调试功能，但通过安装插件可以实现完整的 PHP 开发环境，包括语法高亮、自动补全、代码提示和 Xdebug 调试。下面介绍如何用 Sublime Text 搭建支持 Xdebug 的 PHP 开发环境。
安装必要插件
打开 Sublime Text，使用 Package Control 安装以下插件：
- PHP Companion：提供 PHP 特定的代码跳转、自动补全（如类名、函数）。
- SublimeCodeIntel 或 IntelliSense：增强代码提示功能。
- Debugger（推荐）或 Xdebug Client：用于连接 Xdebug 进行断点调试。
配置本地 PHP 环境
确保你的系统已安装 PHP 并配置好 Web 服务器（如 Apache/Nginx + PHP-FPM），或者使用集成环境如 XAMPP、WAMP、Laragon、Docker 等。
测试 PHP 是否正常运行：
立即学习“PHP免费学习笔记（深入）”；
配置 php.ini 启用 Xdebug
找到你的 php.ini 文件（可通过 phpinfo() 查看路径），添加或修改以下内容：
[xdebug] zend_extension="路径/to/php_xdebug.dll" ; Windows ; zend_extension=/usr/lib/php/extensions/.../xdebug.so ; Linux/Mac 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" ; 可选：记录调试日志（Windows）注意：Xdebug 3 使用 xdebug.mode=debug，端口默认是 9003；旧版本用 xdebug.remote_enable=1 等配置。
保存后重启 Web 服务，并再次运行 phpinfo()，检查是否出现 Xdebug 模块。
在 Sublime 中配置 Debugger 插件
推荐使用 Sublime 的 Debugger 插件（功能更现代，支持 DAP 协议）：
- 安装 Debugger 插件后，在菜单栏选择 Tools → Debugger → Open Launch Configurations
- 选择 PHP 环境，创建配置文件，内容如下：
{
"configurations": [
{
"type": "php",
"request": "launch",
"name": "Listen for Xdebug",
"port": 9003,
"pathMappings": {
"/var/www/html": "${folder}",
"C:/www/project": "${folder}"
}
}
]
}
说明：pathMappings 需将服务器上的绝对路径映射到本地项目路径。例如，你项目在 C:/www/myproject，则 ${folder} 表示该目录，左侧写服务器对应路径。
开始调试 PHP 代码
设置断点并启动调试：
- 在 Sublime 中打开 PHP 文件，点击行号旁设置断点（红点）。
- 点击菜单 Tools → Debugger → Start Debugging，或按 F5。
- 在浏览器中访问目标页面，例如 http://localhost/test.php?XDEBUG_SESSION_START=1
如果配置正确，Sublime 会暂停在断点处，你可以查看变量、单步执行、继续运行等。
也可以安装浏览器扩展（如 Xdebug Helper）来一键开启调试会话，无需手动加参数。
基本上就这些。只要路径映射准确、Xdebug 正常加载、端口未被占用，调试就能顺利运行。适合轻量级 PHP 开发场景，不复杂但容易忽略细节。
