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

在使用 VS Code 进行 PHP 代码调试时，Xdebug 可能会意外地停止在非预期的位置，例如函数声明处，甚至忽略你设置的断点。这通常与使用的 PHP 和 Xdebug 版本有关，尤其是在 Xdebug 2.9.1 之前的版本中。本文将深入探讨此问题的原因，并提供有效的解决方案，包括禁用 resolved_breakpoints 功能以及避免在监视面板中使用可能导致调试引擎停止运行的代码。

问题根源：resolved_breakpoints 功能

在较早版本的 Xdebug 中，存在一个与 resolved_breakpoints 功能相关的已知问题。此功能旨在提高断点解析的效率，但在某些情况下，会导致 Xdebug 错误地停止在函数声明等非预期的位置。尤其是在 PHP 版本和 Xdebug 版本不匹配时，更容易出现此问题。

解决方案：禁用 resolved_breakpoints

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

"xdebugSettings": {
    "resolved_breakpoints": "0"
}

将此配置添加到你的 launch.json 文件中，通常是在 configurations 数组中的每个配置项中，例如：

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

添加此配置后，重新启动 VS Code 和 PHP 调试会话，问题通常会得到解决。

存了个图

视频图片解析/字幕/剪辑，视频高清保存/图片源图提取

17

查看详情

升级 Xdebug 和 PHP 版本

最佳的长期解决方案是升级到支持的 PHP 和 Xdebug 版本。Xdebug 2.9.1 及更高版本修复了 resolved_breakpoints 相关的错误。 建议升级到最新的稳定版本，以获得最佳的调试体验和安全性。

注意事项：监视面板中的代码

在使用 Xdebug 调试时，需要注意监视面板中的代码。在 Xdebug 3.1.0 之前的版本中，在监视面板中执行可能导致错误的 broken 代码，可能会导致调试引擎停止运行。例如，如果代码包含未捕获的异常，可能会导致 Xdebug 无法正常工作。 避免在监视面板中使用可能导致错误的代码，尤其是在使用旧版本的 Xdebug 时。

总结

Xdebug 停止在不存在的断点处是一个常见的问题，通常与 PHP 和 Xdebug 版本不兼容以及 resolved_breakpoints 功能有关。通过禁用 resolved_breakpoints 功能或升级到支持的版本，可以有效地解决此问题。 此外，需要注意监视面板中的代码，避免使用可能导致调试引擎停止运行的代码。 通过这些方法，可以确保在使用 VS Code 进行 PHP 代码调试时获得流畅、高效的体验。

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