Xdebug 在 VS Code 中停止在不存在的断点上的问题解决

在使用 VS Code 进行 PHP 代码调试时，Xdebug 可能会意外地停止在函数声明处，而非预设的断点位置，导致调试流程中断。这个问题通常是由于使用的 PHP 和 Xdebug 版本不兼容，以及 VS Code 插件的 resolved_breakpoints 功能引起的。本文将提供针对此问题的解决方案，包括临时禁用该功能以及检查其他可能导致调试异常的原因。

问题分析

Xdebug 调试过程中，如果调试器停止在函数声明处，而不是你设置的断点处，这通常表明 Xdebug 在断点解析上存在问题。特别是当使用的 PHP 和 Xdebug 版本较旧时，这个问题更为常见。VS Code 的 PHP Debug 插件中的 resolved_breakpoints 功能可能会加剧此问题。

解决方案

1. 禁用 resolved_breakpoints 功能（临时方案）

一个临时的解决方案是禁用 VS Code PHP Debug 插件的 resolved_breakpoints 功能。这可以通过在 launch.json 配置文件中添加 xdebugSettings 来实现。

打开 .vscode/launch.json 文件，找到你的调试配置（例如 "Listen for XDebug" 或 "Launch currently open script"），并在该配置中添加以下内容：

   {
       "name": "Listen for XDebug",
       "type": "php",
       "request": "launch",
       "port": 9090,
       "xdebugSettings": {
           "resolved_breakpoints": "0"
       }
   }

这段配置告诉 Xdebug 禁用断点解析功能，这可以避免调试器错误地停止在函数声明处。

2. 升级 PHP 和 Xdebug 版本（推荐方案）

最有效的解决方案是升级你的 PHP 和 Xdebug 版本。旧版本的 Xdebug 可能存在已知的问题，这些问题在新版本中已经得到修复。

• 升级 PHP: 访问 PHP 官方网站 (https://www.php.cn/link/7b8cc7bf27b727ec89a8f284b316d98d) 下载最新版本的 PHP。

  

  AI建筑知识问答

  用人工智能ChatGPT帮你解答所有建筑问题

  22

  查看详情

• 升级 Xdebug: 使用 PECL 命令安装或升级 Xdebug：

  pecl install xdebug

  登录后复制

  安装完成后，确保在 php.ini 文件中启用 Xdebug 扩展。

  zend_extension=xdebug.so

  登录后复制

  重启你的 Web 服务器 (例如 Apache) 以使更改生效。

3. 检查 Watch 面板中的变量

在 Xdebug 3.1.0 之前的版本中，eval 损坏的代码会导致调试引擎停止正常工作。如果在 Watch 面板中添加了变量，Xdebug 可能会尝试 eval 这些变量，如果变量表达式存在问题，可能会导致调试器停止。

尝试清空 Watch 面板，看看是否能解决问题。

注意事项

• 确保 launch.json 文件中的端口号 (通常是 9000 或 9090) 与 php.ini 文件中 Xdebug 的配置一致。
• 检查你的防火墙设置，确保 VS Code 和 Xdebug 之间的通信没有被阻止。
• 如果问题仍然存在，尝试重启 VS Code 和你的 Web 服务器。

总结

Xdebug 在 VS Code 中停止在不存在的断点上的问题通常可以通过禁用 resolved_breakpoints 功能或升级 PHP 和 Xdebug 版本来解决。同时，检查 Watch 面板中的变量也是一个值得尝试的步骤。通过以上方法，你应该能够恢复正常的 PHP 代码调试流程。

以上就是Xdebug 在 VS Code 中停止在不存在的断点上的问题解决的详细内容，更多请关注php中文网其它相关文章！