XAMPP环境下怎么通过VS Code实现PHP远程调试配置

在XAMPP搭建的本地PHP开发环境中，通过VS Code实现远程调试可以让开发者逐行跟踪代码执行逻辑，快速定位程序运行中的问题。整个配置过程主要涉及Xdebug扩展的安装、PHP配置文件的调整以及VS Code调试参数的设置三个核心环节。

前期准备

首先需要确认当前XAMPP环境中PHP的版本信息，这一步是安装对应版本Xdebug扩展的基础。可以新建一个PHP文件，写入以下代码查看PHP版本和编译器信息：

<?php
phpinfo();
?>

在浏览器中访问该文件，记录PHP版本、Compiler版本、Thread Safety状态等信息，后续安装Xdebug时需要严格匹配这些参数。

安装Xdebug扩展

访问Xdebug官方适配页面，将刚才获取的PHP信息粘贴到页面输入框中，系统会自动推荐适合当前环境的Xdebug版本，并提供对应的下载链接和安装指引。

下载对应版本的DLL文件后，将其放到XAMPP目录下PHP的ext文件夹中，比如默认路径为C:xamppphpext。

配置php.ini文件

打开XAMPP目录下PHP的配置文件php.ini，一般在C:xamppphpphp.ini路径，在文件末尾添加以下Xdebug配置参数：

[xdebug]
zend_extension=php_xdebug.dll
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes

需要注意zend_extension的值要填写你下载的DLL文件的完整名称，如果文件放在ext目录下也可以直接写文件名。配置完成后重启XAMPP的Apache服务，让配置生效。

可以再次访问之前的phpinfo页面，搜索Xdebug关键词，确认扩展已经正常加载。

配置VS Code调试环境

打开VS Code，在扩展商店中搜索PHP Debug插件，安装由Felix Becker发布的官方插件，安装完成后重启VS Code。

打开你的PHP项目文件夹，点击左侧的调试面板，点击创建launch.json文件，选择PHP环境，会自动生成默认配置，调整配置内容如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003
        }
    ]
}

这里的port参数需要和php.ini中配置的xdebug.client_port保持一致，默认Xdebug 3.x版本使用9003端口，如果是2.x版本则使用9000端口。

调试验证

在PHP代码中设置断点，点击VS Code调试面板的开始调试按钮，然后在浏览器中访问对应的PHP页面，程序执行到断点位置时会自动暂停，VS Code会显示当前的变量值、调用栈等信息，此时可以逐行执行代码，观察程序运行状态。

如果遇到调试无法触发的情况，可以检查以下几点：Apache服务是否正常重启、php.ini中Xdebug配置是否正确、VS Code的端口是否和Xdebug配置一致、断点是否设置在可执行的代码行上。

XAMPPPHPVS_Code远程调试Xdebug修改时间：2026-07-20 06:57:19