要调试PHP应用需配置Xdebug与VSCode，先安装PHP、Xdebug及PHP Debug插件，再在php.ini中启用Xdebug并设置模式、端口等参数，接着在VSCode中创建launch.json配置监听端口与路径映射，最后启动调试并访问应用触发断点。
要在 VSCode 中调试 PHP 应用，核心是使用 Xdebug 配合 PHP Debug 插件。整个过程包括环境准备、配置 Xdebug、设置 VSCode 的 launch.json 文件。只要这几步正确，断点调试就能顺利运行。
1. 安装必要组件
确保你的开发环境中已安装以下内容：
- PHP：命令行可执行 php，建议版本 7.0 及以上
- Xdebug：PHP 扩展，用于提供调试能力
- VSCode PHP Debug 插件：在扩展商店搜索 "PHP Debug" 并安装（由 Felix Becker 维护）
安装 Xdebug 的方式取决于你的系统。例如，在 Ubuntu 上可通过：
sudo apt-get install php-xdebug如果你使用的是 Windows + WAMP/XAMPP，Xdebug 的 DLL 文件需手动下载并配置到 php.ini 中。
立即学习“PHP免费学习笔记（深入）”；
2. 配置 php.ini 启用 Xdebug
找到你的 php.ini 文件（可通过 php -i | grep 'php.ini' 查看路径），添加或修改以下内容（以 Xdebug 3 为例）：
[xdebug] zend_extension=xdebug xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003 xdebug.log="/tmp/xdebug.log"说明：
系统易学易懂，用户只需会上网、不需学习编程及任何语言，只要使用该系统平台，只要会打字，即可在线直接完成建站所有工作。本程序适合不懂php环境配置的新手用来在本机调试智能SiteSEO网站优化软件，安装过程极其简单。您的网站地址：http://localhost您的网站后台：登录地址： http://localhost/admin.php密 码： admin服务器套件所包含的软件：nginx-0.7
- xdebug.mode=debug 表示启用调试模式
- xdebug.start_with_request=yes 表示每个请求都尝试连接调试器
- client_port=9003 是默认端口，与 VSCode 调试监听一致
- 日志路径有助于排查连接问题
保存后重启 Web 服务（如 Apache 或 PHP 内置服务器）。
3. 配置 VSCode launch.json
打开项目根目录，在 .vscode 目录下创建或编辑 launch.json，内容如下：
{ "version": "0.2.0", "configurations": [ { "name": "Listen for Xdebug", "type": "php", "request": "launch", "port": 9003, "pathMappings": { "/var/www/html": "${workspaceFolder}" }, "log": true }, { "name": "Launch currently open script", "type": "php", "request": "launch", "program": "${file}", "cwd": "${fileDirname}", "port": 9003 } ] }关键字段解释：
- port：必须与 xdebug.client_port 一致
- pathMappings：将服务器上的绝对路径映射到本地项目路径，尤其在使用 Docker 或远程服务器时必需
- log: true：开启调试器日志，输出到调试控制台，便于排错
4. 开始调试
调试流程如下：
- 在 VSCode 中打开一个 PHP 文件，点击左侧边栏第四个图标（运行和调试）
- 选择 “Listen for Xdebug” 配置，点击“运行”按钮（绿色三角）
- 访问你的 PHP 应用页面（如通过浏览器打开 http://localhost:8000）
- 如果一切正常，VSCode 会在你设置的断点处暂停执行
若未触发，检查 Xdebug 日志、确保没有防火墙阻拦 9003 端口，并确认 pathMappings 正确。
基本上就这些。配置一次后，后续项目只需复制 launch.json 和 Xdebug 设置即可复用。不复杂但容易忽略细节，比如路径映射或端口不一致。
