Xdebug 在 VS Code 中停止在不存在的断点处：问题排查与解决方案

在使用 VS Code 进行 PHP 代码调试时，Xdebug 可能会意外地在函数声明处停止，而忽略用户设置的断点，导致调试无法正常进行。本文旨在帮助开发者诊断并解决这一问题，提供临时解决方案和根本修复方法，确保调试环境的稳定性和可靠性。

问题描述

在使用 VS Code 调试 PHP 代码时，Xdebug 可能会出现以下异常行为：

• 忽略用户在代码中设置的断点。
• 在函数声明处意外停止，例如 function x($a) { ... }。
• 即使在函数声明处停止，也无法进入函数内部进行调试。

问题原因

这个问题通常与以下因素有关：

• PHP 和 Xdebug 版本不兼容： 较旧的 PHP 版本和 Xdebug 版本可能存在已知的问题，导致断点解析错误。
• VS Code PHP Debug 扩展的 resolved_breakpoints 功能： 该功能在某些情况下可能导致断点解析出现问题。
• 监视面板中的变量： 在 Xdebug 3.1.0 之前的版本中，监视面板中存在错误的代码可能会导致调试引擎停止运行。

解决方案

以下是几种可能的解决方案，可以尝试解决 Xdebug 在 VS Code 中停止在不存在的断点处的问题：

1. 升级 PHP 和 Xdebug 版本

这是最推荐的解决方案。确保你使用的 PHP 和 Xdebug 版本是兼容且最新的。Xdebug 2.9.1 修复了 resolved_breakpoints 相关的已知问题。升级步骤如下：

• 更新 PHP： 根据你的操作系统和服务器环境，按照官方文档的指导更新 PHP 版本。

• 更新 Xdebug： 使用 pecl 命令更新 Xdebug：

  

  AI建筑知识问答

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

  22

  查看详情

  pecl update-channels
  pecl install xdebug

  登录后复制

  更新后，重启你的 Web 服务器。

2. 禁用 resolved_breakpoints 功能 (临时方案)

如果升级 PHP 和 Xdebug 版本不可行，可以尝试禁用 VS Code PHP Debug 扩展的 resolved_breakpoints 功能。在你的 launch.json 文件中，添加以下配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for XDebug",
      "type": "php",
      "request": "launch",
      "port": 9090,
      "xdebugSettings": {
        "resolved_breakpoints": "0"
      }
    },
    {
      "name": "Launch currently open script",
      "type": "php",
      "request": "launch",
      "program": "${file}",
      "cwd": "${fileDirname}",
      "port": 9090,
      "xdebugSettings": {
        "resolved_breakpoints": "0"
      }
    }
  ]
}

该配置指示 Xdebug 忽略 resolved_breakpoints 功能，从而避免断点解析错误。

注意： 这是一个临时解决方案，可能会影响调试体验。建议在升级 PHP 和 Xdebug 后移除此配置。

3. 检查监视面板中的变量

如果问题仍然存在，请检查 VS Code 的监视面板中是否存在任何无效或错误的代码。在 Xdebug 3.1.0 之前的版本中，监视面板中存在错误的代码可能会导致调试引擎停止运行。

• 移除无效变量： 从监视面板中移除任何无法解析或导致错误的变量。
• 重启调试： 移除无效变量后，重新启动调试会话。

总结

Xdebug 在 VS Code 中停止在不存在的断点处的问题通常与 PHP 和 Xdebug 版本不兼容、VS Code PHP Debug 扩展的 resolved_breakpoints 功能或监视面板中的变量有关。通过升级 PHP 和 Xdebug 版本、禁用 resolved_breakpoints 功能或检查监视面板中的变量，可以解决此问题，确保调试环境的稳定性和可靠性。建议优先升级 PHP 和 Xdebug 版本，以获得最佳的调试体验。

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