在使用 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 调试会话，问题通常会得到解决。
升级 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 代码调试时获得流畅、高效的体验。
