PHP开发者可通过VS Code结合Xdebug实现高效本地调试。首先安装PHP并配置Xdebug扩展，在php.ini中设置zend_extension、xdebug.mode=debug、client_port=9003和client_host=127.0.0.1，重启服务后验证加载；接着在VS Code中安装“PHP Debug”插件，创建launch.json配置监听端口9003及路径映射；启动调试会话后，通过CLI执行php脚本或访问Web请求触发断点，配合浏览器扩展自动附加调试参数；可查看变量、调用栈并逐行调试；建议开启Xdebug日志、检查防火墙、使用Xdebug 3语法，并在生产环境禁用以保性能。
安装PHP和Xdebug
确保系统中已安装PHP，并启用Xdebug扩展。可在php.ini中添加以下配置：
- 下载对应版本的Xdebug DLL（Windows）或通过包管理器安装（Linux/macOS）
- 在php.ini中加入：zend_extension=xdebug.so（Linux/macOS）或 zend_extension=php_xdebug.dll（Windows）
- 设置Xdebug模式为调试：xdebug.mode=debug
- 配置监听端口：xdebug.client_port=9003
- 指定IDE主机：xdebug.client_host=127.0.0.1（若在Docker中需设为主机IP）
配置VS Code和PHP Debug插件
在VS Code中安装“PHP Debug”扩展（由felixfbecker提供），这是支持Xdebug的核心插件。
- 打开项目文件夹，在运行面板中点击“创建 launch.json”
- 选择环境为“PHP”，生成基础配置文件
- 确保配置中包含："name": "Listen for Xdebug","request": "launch","port": 9003
- 路径映射（尤其使用Docker时）："pathMappings": {"/var/www/html": "${workspaceFolder}"}
启动调试会话
调试可通过命令行脚本或Web请求触发。两种方式都需要先在VS Code中启动监听（点击“开始调试”按钮或按F5）。
- 调试CLI脚本：直接运行 php script.php，Xdebug会自动连接
- 调试Web请求：访问 http://localhost:8000，配合PHP内置服务器
- 使用浏览器扩展（如Xdebug Helper）自动附加XDEBUG_SESSION_START参数
- 在代码中点击行号设置断点，执行到该行时会暂停并显示变量状态
常见问题与优化建议
调试失败通常源于配置不匹配。注意检查端口、路径和Xdebug版本兼容性。
立即学习“PHP免费学习笔记（深入）”；
- 确认Xdebug日志输出：xdebug.log=/tmp/xdebug.log，用于排错
- 避免防火墙阻止9003端口
- 使用Xdebug 3语法（mode=debug），旧版配置已不适用
- 在生产环境中务必关闭Xdebug，以免影响性能
