升级WampServer至3.2.9后VSCode调试器失效，求问题排查

开发者阿泽

2026-8-15

解决WampServer升级后VSCode PHP调试失效问题

核心排查与修复步骤

1. 确认修改的是当前PHP版本的配置文件

WampServer多PHP版本共存时，每个版本都有独立的php.ini：

右键Wamp图标 → PHP → 选中当前使用的8.1.11版本 → 点击php.ini打开，确保修改的是该文件，而非其他版本的配置。

2. 替换Xdebug 3.x的正确配置参数

你添加的xdebug_remote_enable = 1是Xdebug 2.x的参数，Xdebug 3.x已废弃该参数，需替换为以下配置：

[xdebug]
zend_extension = php_xdebug-3.1.5-8.1-vs16-x86_64.dll
xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.client_port = 9003
xdebug.client_host = localhost

注意zend_extension后的文件名要和你PHP扩展目录中的Xdebug文件完全一致
xdebug.mode = debug：启用调试模式
xdebug.start_with_request = yes：替代旧版xdebug_autostart，自动触发调试
xdebug.client_port = 9003：Xdebug3默认端口，需和VSCode配置匹配

3. 验证Xdebug是否正确加载

修改配置后重启Apache，创建PHP文件输出phpinfo()，搜索Xdebug：

确认页面中存在Xdebug模块信息，且xdebug.mode值为debug，xdebug.client_port为9003
若没有Xdebug信息，检查zend_extension的路径是否正确，Wamp中扩展通常在php\php8.1.11\ext目录下

4. 检查VSCode的launch.json配置

打开VSCode的.vscode/launch.json，确保配置匹配Xdebug3：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "C:/wamp64/www": "${workspaceFolder}"
            }
        }
    ]
}