Windows环境Xdebug安装成功但VS Code调试断点不生效求助

问题根因 #

你使用的是Xdebug 3.x版本，但php.ini中仍在使用Xdebug 2.x的废弃配置项xdebug.remote_enable、xdebug.remote_autostart，这类参数在Xdebug 3中已经完全不生效，是断点无法触发的核心原因。

解决步骤 #

• 替换php.ini中的Xdebug配置为以下内容：

[XDebug]
zend_extension = "D:\xampp\php\ext\php_xdebug-3.0.4-8.0-vs16-x86_64.dll"
; 开启调试模式
xdebug.mode = debug
; 所有请求自动触发调试
xdebug.start_with_request = yes
; 匹配VS Code配置的监听端口
xdebug.client_port = 9003
; 调试客户端地址，本地调试默认填127.0.0.1
xdebug.client_host = "127.0.0.1"

• 保存配置后重启XAMPP的Apache服务，运行xdebug_info()确认上述配置已被正确加载。
• 启动VS Code调试时，选择「Listen for Xdebug」配置项再运行。
• 调试时通过浏览器访问http://localhost域名下的对应PHP页面触发请求，不要直接在VS Code中打开本地PHP文件运行。
• 如果仍未生效，暂时关闭系统防火墙后重试，排除9003端口被拦截的可能。

内容的提问来源于stack exchange，提问作者Văn Hữu