首先安装Xdebug扩展并配置php.ini启用调试模式，再在VS Code中安装PHP Debug插件并设置launch.json，最后通过浏览器或命令行触发调试，实现断点暂停与变量查看。
如果您在开发PHP应用时需要逐行检查代码执行流程，定位变量异常或逻辑错误，可以通过Xdebug扩展实现断点调试。以下是配置Xdebug进行PHP代码调试的具体步骤。
本文运行环境：MacBook Pro，macOS Sonoma
一、安装Xdebug扩展
Xdebug是一个PHP扩展，用于增强PHP的调试和性能分析能力。通过它可以在IDE中设置断点并查看变量状态。
1、打开终端，使用PECL命令安装Xdebug：pecl install xdebug。
立即学习“PHP免费学习笔记（深入）”；
2、安装完成后，确认扩展文件生成路径，通常位于/usr/local/lib/php/extensions/no-debug-non-zts-xxx/xdebug.so。
二、配置php.ini启用Xdebug
为了让PHP解析器加载Xdebug扩展，必须在php.ini中添加对应配置项。
1、找到当前使用的php.ini文件位置，可通过命令php --ini查看。
2、用文本编辑器打开php.ini，在末尾添加以下内容：
[xdebug]
zend_extension="/usr/local/lib/php/extensions/no-debug-non-zts-xxx/xdebug.so"
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_port=9003
xdebug.client_host=127.0.0.1
三、配置VS Code调试环境
使用Visual Studio Code配合PHP Debug插件可以图形化操作断点调试。
1、在VS Code扩展市场中搜索并安装PHP Debug插件。
2、在项目根目录下创建.vscode/launch.json文件。
3、在launch.json中添加如下配置：
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003,
"pathMappings": {
"/var/www/html": "${workspaceFolder}"
}
}
]
}
四、启动调试会话
完成配置后即可启动调试，验证是否能成功命中断点。
1、在VS Code中打开一个PHP文件，并在某一行点击左侧行号区域设置断点。
2、点击调试面板中的“Listen for Xdebug”启动监听。
3、通过浏览器访问目标PHP脚本，例如http://localhost:8000/index.php。
4、当代码执行到断点处时，VS Code将自动暂停并高亮当前行，可查看作用域内变量值。
五、使用命令行触发调试
对于CLI模式下的PHP脚本，也可以启用Xdebug进行调试。
1、在终端执行PHP脚本前，先设置环境变量：export XDEBUG_CONFIG="client_port=9003"。
2、运行脚本命令：php /path/to/script.php。
3、如果VS Code已开启监听且断点已设置，则程序会在指定位置暂停。
