在使用 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：
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 版本，以获得最佳的调试体验。
