VS Code安装PHP Xdebug报错：依赖未知felixfbecker.php-debug扩展求解决

原因分析 #

报错提示依赖未知的felixfbecker.php-debug，本质是因为你安装的xdebug.php-debug是原felixfbecker.php-debug的官方继任扩展，但扩展的依赖配置残留了旧标识，或是VS Code的扩展缓存出现异常，导致系统误判新扩展需要已废弃的旧扩展。实际上新版本的PHP Xdebug扩展完全独立，不需要依赖旧版。

解决步骤 #

1. 彻底清理并重装扩展 #

• 打开VS Code扩展面板（快捷键Ctrl+Shift+X），找到已安装的「PHP Debug」（xdebug.php-debug），点击卸载
• 关闭VS Code，找到扩展缓存目录：Windows系统路径为%USERPROFILE%\.vscode\extensions，删除所有包含felixfbecker或xdebug的文件夹
• 重新打开VS Code，搜索「PHP Debug」并安装xdebug官方版本

2. 修正配置文件格式 #

你提供的配置里存在转义引号（"），这会导致VS Code无法识别配置，需修正为正常双引号：

正确的settings.json配置：

"php.debug.executablePath": "C:\\xampp\\php\\php.exe",
"php.validate.executablePath": "C:\\xampp\\php\\php.exe"

正确的launch.json配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch built-in server and debug",
            "type": "php",
            "request": "launch",
            "runtimeArgs": [
                "-S",
                "localhost:8000",
                "-t",
                "."
            ],
            "port": 9003,
            "serverReadyAction": {
                "action": "openExternally"
            }
        },
        {
            "name": "Debug current script in console",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "externalConsole": false,
            "port": 9003
        },
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003
        }
    ]
}

3. 验证Xdebug本身的有效性 #

• 打开终端，运行php -v命令，确认输出中包含Xdebug版本信息，说明PHP已正确加载扩展
• 核对php.ini配置：确保zend_extension路径指向正确的php_xdebug.dll，xdebug.mode=debug和xdebug.start_with_request=yes配置无误，且端口9003与launch.json中的port保持一致

内容的提问来源于stack exchange，提问作者acha