如何在Ubuntu 22.04的VSCode中启用XDebug步进调试

问题描述 #

• 运行环境：Ubuntu 22.04、PHP 8.1、Laravel 10
• Laravel项目通过php artisan serve命令正常启动开发服务
• 已执行sudo apt install php-xdebug安装XDebug扩展，配置文件路径为/etc/php/8.1/mods-available/xdebug.ini
• 已安装VSCode的XDebug插件，默认生成的launch.json内容如下：

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

参考多篇过时教程后仍无法启用XDebug的「步进调试」功能，需明确需要修改的配置项。

解决方案 #

修改/etc/php/8.1/mods-available/xdebug.ini文件，配置内容调整为：

zend_extension=xdebug.so
xdebug.mode = debug
xdebug.start_with_request = yes

配置完成后，XDebug即可正常启用步进调试功能。

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